Rasa: New docs: legacy docs deployment + links

Created on 4 Aug 2020  路  5Comments  路  Source: RasaHQ/rasa

With the new docs system in place, we need a way to link to legacy docs.

Current setup

  1. Rasa docs are deployed on Netlify here. They are then embedded (via Netlify redirects) in the rasa.com website
  2. Legacy docs (for 0.x) are deployed on Netlify here.
  3. no updates are made to these docs anymore

Proposal: New setup

  1. Rasa 2.x docs are deployed on Netlify here. They will be embedded like the current docs, under rasa.com. At the moment they are available through a redirect from rasa.com/docs/rasa/next/
  2. Rasa 1.x will be hosted at: _legacy-docs-v1.rasa.com/_
  3. Rasa 0.x will be hosted at either: _legacy-docs-v0.rasa.com/_

These would be setup via Netlify redirects. We can keep the deploy settings for 1.x docs because it will still be useful if we want to push docs on feature branches, but eventually we should remove it.

Last but not least, we will need to link to those docs:

  • we can do it in the homepage, like we do now:
    Screenshot 2020-08-04 at 17 40 10
  • and/or we can add links to the legacy docs in the dropdown of versions:
    Screenshot 2020-08-04 at 17 40 59
area type

All 5 comments

cc @tmbo @lunelson I forgot to create the task at the time, so here it is, with a proposal in the desc!

Yes I would suggest we make the following new subdomains:

legacy-docs-v0.rasa.com
legacy-docs-v1.rasa.com

...and then redirect the current legacy-docs to legacy-docs-v0 with a splat and 301

Sounds good, let鈥檚 goooo 馃殌

@lunelson I just saw that you added this to your board, but I was planning to make progress on this during the week. Can I steal this from you? (I'll most probably ask for a review from you!)

@m-vdb yes, no problem 馃憤 !

Was this page helpful?
0 / 5 - 0 ratings