Comments (9)
The version mapping I had, but that doesn't help with the new documentation, as I don't know what was available in those versions, now everything shows 4.1. I am currently running TFS2017.2 so I need to be able to see what api's are available in 3.2.
Just like on the other documentation that has filtering based on whether it is VSTS, TFS2018, TFS2017, etc, the api's documentation requires this as well so that we can correctly see what is available to use. Being able to only see the latest for a version we are not even able to use is not helpful.
I am right in the middle of designing a customization and can't as I don't know what's available at my version.
from vsts-rest-api-specs.
We've renamed the folder for these docs. Here is the new link https://docs.microsoft.com/en-us/vsts/integrate/previous-apis/overview?view=vsts
from vsts-rest-api-specs.
Thanks for your feedback. I've provided a version mapping which should help distinguish between version number. Unfortunately there isn't a way for us to show which apis are supported on TFS. This is something we certainly need to add. I'm adding an enhancement tag and leaving this issue open until we can resolve.
Version mapping
3.0 - 2017 RTM
3.1 - 2017 update 1
3.2 - 2017 update 2
4.0 - 2018
4.1 - 2018 update 2
from vsts-rest-api-specs.
Perhaps going back in history and create a seperate branch per api version?
Or do you want to keep a single source tree with all api versions in it?
from vsts-rest-api-specs.
The issue seems to be being handled in other parts of the documentation. I would recommend something like what is being down with powershell: https://docs.microsoft.com/en-us/powershell/scripting/powershell-scripting?view=powershell-6. Providing a filter for the API version would be extremely useful.
from vsts-rest-api-specs.
Our older apis are now available on our docs site. They can be found here https://docs.microsoft.com/en-us/vsts/integrate/legacy-apis/overview?view=vsts. This should hopefully unblock your development.
from vsts-rest-api-specs.
Why would you put this under Legacy? This is still valid information and should all be in the same location. Going forward how are the different versions of api's going to be handled? I hope that filtering will be applied to the standard location as well as v4.2, v5.0, v5.1, etc. comes out.
Ideally it would be best if the filtering applied to the api's was based on their version.
from vsts-rest-api-specs.
Ideally yes, these documents would appear in the same section but it's not as easy for us to do this right now. To unblock development ASAP, we've decided to port over a copy of our old documentation site. Going forward, we will have a version selector which allows you to toggle between different api versions and it will be applied to our standard location.
from vsts-rest-api-specs.
That works for me. Thank you. I look forward to the final update to the docs.
from vsts-rest-api-specs.
Related Issues (20)
- Dead URL on Azure DevOps Services REST API Reference HOT 1
- Filter build on repositoryId or repositoryType fail with Bad Request
- Update document for ConvertAuthenticationScheme
- Unable to create dashboard with example
- Is there a limit on the number that can be returned?
- [Suggestion/Question] Azure DevOps > Git > Diffs - Is there a way to get the actually line changes (Git diff) through the api?
- Wrong status code
- API documentation does not seem to conform to actual behavior - does it need update?
- Better examples - an exact command
- Get user by email?
- Azure DevOps Accounts List won't work for Service Principals
- Examples for Resources
- Azure DevOps REST API - Work Item Relation Type URL Format Is Not Explicit
- https://dev.azure.com/{yourorganization HOT 1
- "Pipelines - List" REST API docs have a mistake
- Release
- Invoke
- Mistake in "Add a link" example
- Service Endpoint REST API The String length exceeds maximum limit
- criteria.confidenceLevels default value is wrong
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from vsts-rest-api-specs.