MicrosoftDocs / vsts-rest-api-specs

MIT License
158 stars 114 forks source link

Examples do not make sense #646

Open TeunissenHarry opened 5 months ago

TeunissenHarry commented 5 months ago

The examples show the outcome of an input that never happened. Make your product more accessible voor novice-users (like myself) by giving them reallife examples please. For instance: this 'example'https://dev.azure.com/{organization}/{project}/_apis/wit/queries/{query}" would never work nor lead to the outcome listed under the example because of the use of {query}, here you should rather use some phrase like 'path to your root folder', or likewise. So in my opinion a better example would be: https://dev.azure.com/{organization}/{project}/_apis/wit/queries/{'path to your root folder'}

[Enter feedback here]


Document Details

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