[ 
https://issues.apache.org/jira/browse/MESOS-9241?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16619185#comment-16619185
 ] 

Alexander Rukletsov commented on MESOS-9241:
--------------------------------------------

A brief searching reveals that [there are arguments for 
both|https://stackoverflow.com/questions/10302179/hyphen-underscore-or-camelcase-as-word-delimiter-in-uris],
 however for REST and REST-like APIs underscore {{_}} seems the standard de 
facto:
https://api.stripe.com/v1/subscription_items
https://developer.twitter.com/en/docs/api-reference-index.html
https://www.graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/finance_permissions?user=<USER_ID>&finance_permission=<FINANCE_ROLE>

Hence the suggestion is to standardise on {{_}} in Mesos.

> Delimiters in endpoint names are inconsistent across mesos components.
> ----------------------------------------------------------------------
>
>                 Key: MESOS-9241
>                 URL: https://issues.apache.org/jira/browse/MESOS-9241
>             Project: Mesos
>          Issue Type: Improvement
>          Components: HTTP API
>            Reporter: Alexander Rukletsov
>            Priority: Minor
>              Labels: api, tech-debt
>
> At the moment endpoints in Mesos components have both {{-}} and {{_}} as 
> delimiters:
> {noformat}
> /master/create-volumes
> /master/destroy-volumes
> /master/state-summary
> /slave(1)/api/v1/resource_provider
> {noformat}
> This is inconsistency for no good reason.



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)

Reply via email to