[Docs]: Add redirections

[TomFern]

Type

Improvement idea

What do you want to report?

Multiple pages on the product have links to the current docs. We need either to update production, or, more likely, add redirections to equivalent pages on the new docs.

We need a list of links from the app going to docs.semaphoreci.com to create the redirections and mappings

Code of Conduct

• [X] I agree to follow this project's Code of Conduct

[TomFern]

Docusaurus has this plugin for redirection: https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-client-redirects

The plugin has thess warnings:

• This plugin is always inactive in development and only active in production because it works on the build output.
• It is better to use server-side redirects whenever possible. Before using this plugin, you should look if your hosting provider doesn't offer this feature.

[TomFern]

Docs analytics for docs.semaphoreci.com

https://docs.google.com/spreadsheets/d/1ObkljcFlychxh6N1AU2hW7Pqzp9XyfUBINBznNkqhYs/edit?usp=sharing

We can use this information to:

• Create redirection rules
• Find important pages missing in docs

[TomFern]

These are redirections we must implement. This depends on moving the docs to the root of the Docusaurus site.

Tab: mappings https://docs.google.com/spreadsheets/d/1ObkljcFlychxh6N1AU2hW7Pqzp9XyfUBINBznNkqhYs/edit?gid=1176514415#gid=1176514415

[TomFern]

Redirection rules updated to support trailing slash presence or absence.

[TomFern]

The update broke the Algolia Crawler. There is not much debugging information. The main error:

SafeReindexingError: [v2-sxmoon] Blocking error:
  The difference between the number of records:
    from : 3.68k
    to   : 1
  is too large (100 %), this limit can be modified in the Editor (currently 10 %)

The first row is the new index, the second row is the old (previous to the change). The index is only getting one row after the change:

For some reason the cralwer is not moving past the home page:

After discussing with Alek, we'll try making reverting this lines from:

    location /?$ {
      try_files $uri $uri/index.html $uri/ =404;
    }

to:

 location / {
      try_files $uri $uri/index.html $uri/ =404;
    }

and seeing if that fixes it.

[TomFern]

Update: The change on default.conf fixed the index. Redirections also seems to be working as intended.