Need stable link to latest docs

[smhigley]

Widget READMEs need to link to their API docs, but linking to a specific version would be difficult to maintain. Could we add something like /latest/?

[devpaul]

We should create a forwarding mechanism using meta refresh tag when a user goes to /api/<package>. The forwarding page can be built at the same time index.html is since it already updates links to the latest APIs. We can also copy the latest api directory into /api/<package>/latest if that makes linking (i.e. query params) easier.

[kitsonk]

Or we can have rewrite rules on for the webserver... I am not sure what actual server is being used for dojo.io, but some form of rewrite rules should be available.

[devpaul]

GitHub doesn't have rewrite rules (or symlinks). Server tricks are out unless we switch to a real server.

[kitsonk]

There is jekyll-redirect-from.

[devpaul]

jekyll-redirect-from creates html with a meta tag. We used to disable jekyll w/ a .nojekyll file because hexo is our templater. Not sure if we do any more. Even so, if the choice is between adding another system to our build pipeline (jekyll) vs adding some code to our build I would vote for the latter.

This is the entry point for making /api/index.html: https://github.com/dojo/dojo.io/blob/master/support/grunt/tasks/hexo.ts#L18

[kitsonk]

There is this plugin for hexo that does essentially what the jekyll one does.