Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

singular vs. plural in API URLs #9

Open
jar398 opened this issue Jul 26, 2018 · 2 comments
Open

singular vs. plural in API URLs #9

jar398 opened this issue Jul 26, 2018 · 2 comments

Comments

@jar398
Copy link
Contributor

jar398 commented Jul 26, 2018

Michel Franck says:

@jonathan: I was confused by the path difference in '/services/authenticate' vs. /service/cypher'. Maybe having the same path would avoid others to do the same mistake as I did.

My response:

Hmm. I used my understanding of the Ruby on Rails naming convention for singular vs. plural; I believe this appears in other EOL beta site URLs. The thinking is that when you authenticate, this is an operation that covers all the services (plural), while cypher is just one service among many.

I consider Jeremy the last word on URLs, and I have neither an opinion nor enough Rails experience to say. We'll keep track of this for later review, thanks.

@frmichel
Copy link

Hi Jonathan, I'm not familiar with Ruby, I leave it to you to decide what's best on this question.

Franck.

@jar398
Copy link
Contributor Author

jar398 commented Jul 26, 2018

I addressed this in the documentation a bit, which I think will help, but doesn't really address your main suggestion head-on, so I will leave the issue open.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants