Support multiple documentation version sets

[shelleyp]

You're supporting two Node versions at a time.

But you're only providing one set of documents--for the version of Node that's going away in April.

If you're going to support two versions of Node, you have to provide access to the API documentation for both versions.

[fhemberger]

If you look at https://nodejs.org/en/docs/, we are providing API docs for 0.10.x, 0.12.x, the current version and in fact to all Node.js versions back to 0.1: https://nodejs.org/docs/.

[fhemberger]

@rvagg Can we have a 'latest-lts' symlink for API docs as well?

[shelleyp]

If you're going to support two versions of Node at the same time, you need to provide access to both APIs at the top most level of the web site, at the same time. If you're going to have two downloads for Node on your download page, you really need to have two APIs at the top most API page.

[phillipj]

Maybe we should have two API links in the aside on the docs page aswell? E.g:

[shelleyp]

No, not closed.

This page needs to list both. https://nodejs.org/api/

[shelleyp]

Agree with @phillipj suggestion.

[mikeal]

Updated the title to be more productive.

[mikeal]

I'm not convinced that https://nodejs.org/api/ needs to have both. That link has always been to the latest current docs, since literally forever :)

Totally agree that the docs page needs to link to both.

Have we considered also linking to the API docs in the download page for each release and in the automated release post of each release?

[mikeal]

Reopening as I don't see the comment that closed this with links to new issues :(