[LukasGold]

Closes #205.

Note on the base branch

This targets gh-pages, not main. Issue #205 is not a source change: the
leftovers live only on the build-output branch.

Changes

Removes 18 root entries (63 files) and adds a new root 404.html that
redirects missing pages.

404.html, Makefile, assets, auth, authors, changelog, conf.py,
contributing, controller, license, model, objects.inv, osw,
readme, requirements.txt, search, tools, tutorials

At the merge base 15de5cd, the root tree goes from 53 entries to 36: 35 kept entries plus the new 404.html. Merged into the current gh-pages, which has gained the versions 2.8.1 to 2.9.1 since, the root has 40 entries.

Rationale

These are the part of the site deployed before mike that mike did not replace. That site was built with MkDocs. conf.py and Makefile among them are Sphinx build files, and requirements.txt lists both MkDocs and Sphinx packages. Every entry
is byte-identical to
641d919,
deployed on 2026-07-07. The last commit that changed these entries is
327982e,
on 2026-07-02. They will never update again.

They are worse than absent. An unversioned path returns 200 and serves a
superseded page, so checking a documentation link by status code passes while
the reader sees content from July.

404.html is included for a separate reason. GitHub Pages serves a custom 404
only from the root copy, so this file is the live 404 page. Its assets point at
/Tools/assets/... while the site is served at /osw-python/, a wrong
site_url at build time. Every asset it requests under /Tools/ returns 404, so it has not
rendered correctly since the repository was renamed from Tools to osw-python. mike writes a correct latest/404.html, but Pages ignores
per-directory copies.

Kept

• .nojekyll. Its blob matches the July one only because the file is empty.
• Everything mike writes: index.html, versions.json, sitemap.xml,
  sitemap.xml.gz, dev, latest, and the version directories (2.0.0 to
  2.8.0 at the merge base, 2.0.0 to 2.9.1 on the current gh-pages).

Nothing under latest/, dev/ or any version directory is touched.

Redirect of missing pages

The new root 404.html replaces the old one. It has no external assets. For
every missing path, a short inline script redirects to the current page of a
removed pre-mike path, or to the main page /osw-python/ when there is none.
Without JavaScript, a meta refresh redirects to the main page. The HTTP status
of a missing path stays 404. mike writes only its own paths, so the file
remains through later deploys.

The removed paths below return 404 after this change and redirect as listed.
The pre-mike layout differs from the current one, so several have no same-named
replacement.

Removed	Current equivalent
/tools/	/latest/tools/
/osw/	/latest/api/core/
/controller/	/latest/api/controller/
/model/	/latest/api/model/
/auth/	/latest/api/auth/
/license/, /authors/	/latest/about/
/tutorials/, /contributing/, /changelog/, /readme/, /search/	none, redirects to the main page

CI

gh-pages carries no .github/ directory and no pyproject.toml, so no
workflow runs on a pull request against it. No checks will appear. The merge
triggers a Pages build, which publishes the pruned root.

The redirect script was tested with Node against 17 paths, including every removed path in the table and paths outside it.

[simontaurus]

ideally non-existing old url redirect to the main page, but since the documentation was not much used previously not a critical point

[raederan]

fine