[Docs] Adjust publication to remove outdated docs and redirect to the proper default landing page

[agneszitte]

On which page?

• https://platform.uno/docs/articles/uno-check.html (old content)
• https://platform.uno/docs/articles/external/uno.check/doc/using-uno-check.html (new content)

What's wrong?

Having proper redirection on missing content in general.
Like having proper redirection from https://platform.uno/docs/articles/uno-check.html to https://platform.uno/docs/articles/external/uno.check/doc/using-uno-check.html
Uno-check docs pages content should be merged to only have one page with everything related to uno-check

Any feedback?

Note: the uno-check blog post redirect to the readme of the uno-check repo, and this readme redirect to using-uno-check.md

Related issues

• [docs] Additional setup for Linux or WSL is missing #15754
• Uno Roadmap docs page is broken #11691

[jeromelaban]

The fix is not merging documents, it's having proper redirection on missing content (that document was replaced a long time ago, and is still being referenced by search engines).

[agneszitte]

I will check if there is a way to handle the redirection using docfx or if we need another solution

[agneszitte]

Notes from @Youssef1313 :
"I came across this dotnet/docfx#8340 and thought it might be useful.

Also found this while looking in the same topic in the codebase:
https://github.com/dotnet/docfx/blob/f28165af43dde2ec072a79fa2479f475fcd947ad/src/Microsoft.DocAsCode.Build.Engine/XRefMaps/XRefMap.cs#L31-L33

Might be relevant, though not well documented. This page https://dotnet.github.io/docfx/tutorial/links_and_cross_references.html briefly mention that xrefmap.yml can be deployed, but doesn't mention redirections. But from the code above, it looks like redirections should be a thing in xrefmap"

[jeromelaban]

As this is a new feature, we'll need to create an initial diff of the docs based on what's currently published publicly on our docs, then introduce a diffing system to determine if a doc update removes a page from the last CI build.

[morning4coffe-dev]

Cached pages on Google from internal Search epic:

-> https://platform.uno/docs/articles/external/uno.extensions/doc/Learn/Tutorials/Navigation/HowTo-NavigateInCode.html

previously features/windows-devices-sensors.md

missing toc