search

angular / angular.io

Website for the Angular project (see github.com/angular/angular for the project repo)
https://angular.io
MIT License
1.03k stars 880 forks source link

"Latest" documentation will break bookmarks. #3536

Closed gravidThoughts closed 7 years ago

gravidThoughts commented 7 years ago

I imagine that some developers build a knowledge base about the technologies they are working with and rely on bookmarks to access web resources within that system.

For example i have a 4.x tag and a link to the changelog. I access that at the end of this year and I am looking at 5.x changelog.

Is there an architectural reason why latest is used in the url?

Foxandxss commented 7 years ago

A 4.x tag where? The changelog part confused me. Can you explain with more detail?

gravidThoughts commented 7 years ago

Sorry. I meant in my knowledge base system, i have tagged that link with 4.x. When I query against 4.x and changelog tags in my system, it will bring up a link that now really is for 5.x

Also to be clear, this is a simplified example. I may have several entries in my system for a far more complex document than a change log. They would all be broken.

The point being, over time latest in the URL will mean something different. Why not just use an explicit version?

Foxandxss commented 7 years ago

Latest was an idea that began with the project but never took place. So latest is just another piece of the url that conveys no meaning. Our doc will be always the latest docs, except the one we have in v2.angular.io which is the v2 edition.

We are migrating to a new site and we are getting rid of it.

gravidThoughts commented 7 years ago

What will happen when 5 comes out?

Foxandxss commented 7 years ago

we will archive the current site probably like we did with v2

gravidThoughts commented 7 years ago

And new versions of the documentation will have URLs that will never change?

Foxandxss commented 7 years ago

yes sir

gravidThoughts commented 7 years ago

Ty sir!