[PATCH v3] docs: directive `alias` for redirects
Jonathan Corbet
corbet at lwn.net
Thu May 4 11:41:21 PDT 2023
Costa Shulyupin <costa.shul at redhat.com> writes:
> and several redirects for moved main arch pages
>
> Problems:
> - The documentation lacks hierarchy
> - Relocating pages disrupts external links to
> the documentation and causes confusion for users
>
> Benefits:
> - Users can easily access relocated pages from external resources
> - Using redirects frees up options for reorganizing the documentation
>
> The solution:
> - Introduced directive `alias` which declares previous path of
> a moved document as the argument.
> - Redirects are implemented with Sphinx extension rediraffe_redirects.
>
> Signed-off-by: Costa Shulyupin <costa.shul at redhat.com>
>
> ---
>
> Changes:
> - complete new implementation
I honestly don't know why you keep throwing versions of this at us. In
the absence of observed problems, I don't see the value in adding
infrastructure that we have to maintain going forward.
Please stop with this for now.
Thanks,
jon
More information about the linux-snps-arc
mailing list