mesos-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Neil Conway (JIRA)" <>
Subject [jira] [Updated] (MESOS-4787) HTTP endpoint docs should use shorter paths
Date Mon, 29 Feb 2016 19:48:18 GMT


Neil Conway updated MESOS-4787:
    Sprint: Mesosphere Sprint 30

> HTTP endpoint docs should use shorter paths
> -------------------------------------------
>                 Key: MESOS-4787
>                 URL:
>             Project: Mesos
>          Issue Type: Documentation
>          Components: documentation
>            Reporter: Neil Conway
>            Assignee: Kevin Klues
>            Priority: Minor
>              Labels: documentation, mesosphere
> My understanding is that the recommended path for the v1 scheduler API is {{/api/v1/scheduler}},
but the HTTP endpoint [docs|] for this
endpoint list the path as {{/master/api/v1/scheduler}}; the filename of the doc page is also
in the {{master}} subdirectory.
> Similarly, we document the master state endpoint as {{/master/state}}, whereas the preferred
name is now just {{/state}}, and so on for most of the other endpoints. Unlike we the V1 API,
we might want to consider backward compatibility and document both forms -- not sure. But
certainly it seems like we should encourage people to use the shorter paths, not the longer

This message was sent by Atlassian JIRA

View raw message