Skip to content

Docs: lead Start Here with natural language or Python - #688

Merged
Jammy2211 merged 1 commit into
mainfrom
claude/compassionate-sagan-1yv43b
Nov 1, 2026
Merged

Jammy2211 merged 1 commit into
mainfrom
claude/compassionate-sagan-1yv43b

Conversation

@Jammy2211

Copy link
Copy Markdown
Collaborator

Summary

Brings the PyAutoGalaxy docs in line with PyAutoFit's natural-language-first docs, while keeping the pages about galaxy structure first.

  • Start Here (docs/overview/overview_1_start_here.md, not renamed) still opens with galaxy structure and the core aims. The "Human-Readable Overview" heading is dropped, and a new Natural Language or Python section follows:
    • a copyable start-here prompt for the autogalaxy_assistant;
    • access and free options;
    • why natural language;
    • Python is not going anywhere (HowToGalaxy teaches the science).
  • docs/index.md and README.md: the Getting Started section is restructured to match.
  • New User Guide: the assistant boilerplate becomes one paragraph.
  • Prompt box: the copyable nl-prompt container is ported from PyAutoFit (docs/_static/pyautogalaxy.css, copybutton_selector).

Companion to the matching PyAutoLens docs PR.

Validation

  • The Sphinx build gives 115 warnings on both main and this branch, so no new warnings.
  • docs/sphinx_warning_baseline.txt reads 105, so the 115 on main is pre-existing drift in this environment, not caused by this PR.

Generated by Claude Code

Start Here keeps the galaxy-structure opening, then a 'Natural Language or
Python' section: the start-here prompt for the autogalaxy_assistant,
access/free options, why natural language and that the Python API is not
going anywhere (HowToGalaxy teaches the science). index.md and README
Getting Started are restructured to match, the New User Guide's assistant
boilerplate becomes one paragraph, and the copyable nl-prompt box is ported
from PyAutoFit. No new Sphinx warnings (115 on main and branch).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016nhQ8QgLw3SZjRMSaX3v5z
@Jammy2211
Jammy2211 merged commit a6c0de9 into main Nov 1, 2026
4 checks passed
@Jammy2211
Jammy2211 deleted the claude/compassionate-sagan-1yv43b branch November 1, 2026 16:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants