Documenting issues with website and documentation repos

[fzipi]

Right now there are some problems or annoyances that we cannot solve with the current setup of documentation and website in different repos.

Let me add this list here for reference, maybe in the future we can solve this:

• cross linking between them must use external urls, otherwise references won't be found.
• we cannot mount documentation "inside" the website (using hugo mounts), because it will use only one theme, and we have a separated theme for the docs.
• we cannot use aliases in the documentation (e.g. /installation was used a lot in blog posts) to use both urls properly.