Docs: Relabel pages to new top-level "Reference/Policies and legal documents" (Diátaxis)

[benjaoming]

Refs: #9746

This top-level is easiest to introduce and populate in one go.

• Move all articles that are either a policy or a legal document
• Rename all policies to " policy", i.e. not "Policy for ".
• Move contents from old section "Legal documents and policies" and remove legal/index.rst since its replaced by reference/policies.rst

---

📚 Documentation previews 📚

• User's documentation (docs): https://docs--9916.org.readthedocs.build/en/9916/

• Developer's documentation (dev): https://dev--9916.org.readthedocs.build/en/9916/

[ericholscher]

Simple enough, we need to make sure we have a redirect for the rename here though. Are we tracking redirects anywhere?

[benjaoming]

Simple enough, we need to make sure we have a redirect for the rename here though.

Oh yes, I was really hesitating to make this rename, but it just felt sooo messy if I put an index of a section somewhere else.

What if we do this:

1. Keep a standard placeholder at the location of the old page, with :orphan: + this page is moved here: <path>
2. When we want to launch and create redirects, we look for all the placeholders and eliminate them.

[ericholscher]

What if we do this:

1. Keep a standard placeholder at the location of the old page, with :orphan: + this page is moved here: <path>
2. When we want to launch and create redirects, we look for all the placeholders and eliminate them.

I think we just create the redirects now? We could make them on the distaxis branch, then just migrate them to latest & stable after merge.

[benjaoming]

I think we just create the redirects now? We could make them on the distaxis branch

How does that work? Aren't user-defined redirects a global thing so we'd end up redirecting things that are currently live on main?

[benjaoming]

Right Exact redirects FTW 💯

Outcome: /en/diataxis-main/legal/index.html -> /en/diataxis-main/reference/policies.html

[benjaoming]

Alright, should be good to go now 👍

Can test if https://docs.readthedocs.io/en/diataxis-main/legal/index.html will redirect once this has been merged and built.

[ericholscher]

Looks like it redirected properly 👍