dart-lang / api.dart.dev

Dart API docs
https://api.dart.dev
BSD 3-Clause "New" or "Revised" License
19 stars 17 forks source link

Display specific versions #33

Closed d2m closed 9 years ago

d2m commented 9 years ago

Is there a way to display the docs for a different version (except for the LATEST) of the SDK in the browser?

Alternativ: is there a URL template to load index.json/library_list.json for selected versions?

sethladd commented 9 years ago

Unfortunately, it's a manual process right now:

Take a URL like: https://api.dartlang.org/apidocs/channels/stable/dartdoc-viewer/home

Change stable to either be for bleeding edge or dev for dev channel.

d2m commented 9 years ago

That's what i know, but say you want to display the '1.6.0' release from the 'stable' channel?

sethladd commented 9 years ago

Oh, I see. hm. I checked https://github.com/dart-lang/api.dartlang.org/blob/master/server/scripts/redirector.py and it doesn't appear that we can get a specific version number.

I know we're generating docs on every build. We'd have to map version numbers to SVN revisions.

d2m commented 9 years ago

If i'd knew revision numbers, which URL would i use for example for revision 39553 (1.6.0/stable) ?

sethladd commented 9 years ago

I don't think we have such a URL now :(

https://github.com/dart-lang/api.dartlang.org/blob/master/server/scripts/redirector.py is what I'm looking at. Maybe it's there and I can't find it?

alan-knight commented 9 years ago

I think that there was once some ability to do that, there are remnants in that script file, but I don't think it works now.

sethladd commented 9 years ago

the new dartdoc puts the version number into the footer.