handbook/docs
disqualifier 613d8f28ea add Virtual environments page (project isolation + pyenv)
New docs/environments.md, nav 'Virtual environments' (before Deploy):
- the rule: never touch system Python (danger callout)
- project-based isolation as Local .venv / Makefile-driven / Docker tabs,
  each with a runnable snippet; Docker ties back to the deploy standard
- local dev with pyenv: why, official install link, shell init with
  annotated lines, everyday use, per-project .python-version
- shell quality-of-life extras (flake8 alias, .local/bin + npm-global PATH),
  cross-ref'd to Standards and Workflow

workflow.md pyenv bullet now points at the new page; index.md gains a card.

Verified in-browser: tabs switch (Local/Makefile/Docker), annotations and
admonitions render; mkdocs build --strict clean (cross-ref anchors resolve).

Signed-off-by: disqualifier <dev@disqualifier.me>
2026-06-29 20:54:31 -04:00
..
assets add lambda logo, fold sections, add python/error/log snippets 2026-06-29 20:09:30 -04:00
stylesheets rename to 'rethink development', brighten lib table, drop stale note 2026-06-29 20:35:16 -04:00
deploy.md update deploy guide per spec + add licensing standard 2026-06-29 20:51:07 -04:00
environments.md add Virtual environments page (project isolation + pyenv) 2026-06-29 20:54:31 -04:00
index.md add Virtual environments page (project isolation + pyenv) 2026-06-29 20:54:31 -04:00
libraries.md rename to 'rethink development', brighten lib table, drop stale note 2026-06-29 20:35:16 -04:00
standards.md update deploy guide per spec + add licensing standard 2026-06-29 20:51:07 -04:00
workflow.md add Virtual environments page (project isolation + pyenv) 2026-06-29 20:54:31 -04:00