Folder structure for versioned API docs

[melissawm]

This is the first part of adding the versioned docs for napari. The other half is fixing the deployment of the docs from the main site to this branch through github actions (PR here: https://github.com/napari/napari/pull/4635)

To see how this looks, you can check for example the release notes:

• stable: https://melissawm.github.io/napari.github.io/stable/release/release_0_4_15.html
• dev: https://melissawm.github.io/napari.github.io/dev/release/release_0_4_16.html

If you prefer waiting to see the napari/napari github actions PR before merging this one, that would probably be best.

As a note, the github action to be added to napari/napari will deploy any fresh documentation PRs to the dev folder, not touching or deleting any other folders in this setup. But this means these two PRs will need to be merged in tandem so the gh-pages branch doesn't get overwritten in the meantime.

---

Details

Despite the huge list of changed files, they were only moved. This also means the conflicts that are showing up here are irrelevant, as they are merely showing the files that were moved and not any actual changes to content.

• Moved built documentation files to the following folder structure:
  • /dev: current docs from main (will be updated by the github action executed upon merge to main on napari/napari)
  • /stable: symlink to 0.4.16
  • /0.4.15: docs for the 0.4.15 version
  • /0.4.16: docs for the 0.4.16 version
• Updated version switcher to recognize the existing versions

Note that this PR is not against main, but against the gh-pages branch.

[codemonkey800]

awesome! yeah we should probably wait for the GitHub action part since this PR is already running into a bunch of conflicts

[jni]

@melissawm Apologies I missed this the first time around! As discussed in docs working group meeting, could you update the PR, then add a more detailed description of the changes here, since the "files changed" tab is useless? 😂 Thank you!

[melissawm]

Ok @jni - I believe this is ready to go!