search

MicrosoftDocs / vsts-rest-api-specs

MIT License
158 stars 114 forks source link

Missing documentation of branch endpoints #116

Open kimsey0 opened 5 years ago

kimsey0 commented 5 years ago

The azure-devops-node-api Git API interface includes endpoints for listing and working with branches. However, these endpoints aren't documented in the Azure DevOps Services REST API documentation.

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

hross commented 5 years ago

There are rest docs for these APIs here.

kimsey0 commented 5 years ago

Oh, great. Is there any chance those pages can be renamed to contain branches or have some metadata attached so they show up when you filter by title for branch?

hross commented 5 years ago

Unfortunately the documentation is auto-generated based on the API naming convention. I know it's odd that the filter doesn't give you want you want easily. @wnjenkin can take that feedback back to the team who owns the docs.

kimsey0 commented 5 years ago

It's especially odd, since the azure-devops-node-api Git API interface is reportedly also auto-generated and names the endpoints getBranch and getBranches. Is that interface generated based on some other naming convention?