#TIL 41 - How to deploy old legacy documentation with MkDocs

Jul 14, 2023 · Dung Huynh

What

Deploy older versions of documentation (e.g., TypeORM v0.2) when official site only shows latest.

Why

Some projects only host latest docs. Older versions may still be in use.

How

1. Clone specific version:

npx degit typeorm/typeorm#0.2.38 typeorm-legacy

2. Create mkdocs.yml:

site_name: TypeORM v0.2.38
site_url: https://your-url.com/
theme: readthedocs

3. Build and deploy:

pip install mkdocs
mkdocs build
npx vercel deploy

Demo: typeorm-02-38.onrender.com