[Jammy2211]

Summary

Brings the PyAutoLens docs in line with PyAutoFit's natural-language-first docs, while keeping the pages about lensing first.

• Start Here (docs/overview/overview_1_start_here.md, not renamed) still opens with strong lensing and the schematic. A new Natural Language or Python section follows:
  • a copyable start-here prompt for the autolens_assistant;
  • access notes (Claude Code / Codex recommended, free options via the AI Options page);
  • Why natural language? (syntax was never the science; the scientist supplies understanding, direction and judgement; links the PyAuto AI Policy);
  • Python is not going anywhere (the full Python API remains, all docs are written for people to read, HowToLens teaches the science so you can direct an analysis with expertise).
• docs/index.md and README.md: the "Human-Readable Documentation" and "AI Assistant" sections become Natural Language or Python and Documentation and Examples.
• New User Guide: the assistant boilerplate becomes one paragraph.
• Prompt box: the copyable nl-prompt container is ported from PyAutoFit (docs/_static/pyautolens.css, copybutton_selector in conf.py). The shared pyauto.css is untouched.

Companion PRs: the start_here mode in autolens_assistant and autogalaxy_assistant, the same opening in both workspaces' start_here.py, and the matching PyAutoGalaxy docs PR.

Validation

• The Sphinx build gives 130 warnings on both main and this branch, so no new warnings.
• The rendered page was checked visually: the prompt box gets its copy button and the #natural-language-or-python anchor resolves.

---

Generated by Claude Code