docs: route Colab introductions to workspace start

[Jammy2211]

Overview

Introductory Google Colab links for PyAutoLens and PyAutoGalaxy currently open each workspace’s imaging-specific notebook. They should instead open the workspace-root start_here.ipynb, which provides the overall product introduction.

Both root notebooks exist at the referenced release tags and contain the correct product-specific setup_colab bootstrap.

Plan

• Redirect generic PyAutoLens introduction links to the autolens workspace-root notebook.
• Apply the equivalent correction to PyAutoGalaxy links.
• Update matching README, documentation, and paper references across the affected repositories.
• Preserve links explicitly describing the imaging-specific tutorial.
• Verify the release-tag targets and their setup_colab calls.

Detailed implementation plan

Affected Repositories

• PyAutoLens (primary)
• PyAutoGalaxy
• autolens_workspace
• autogalaxy_workspace
• euclid_strong_lens_modeling_pipeline

Branch Survey

Repository	Current Branch	Dirty?
PyAutoLens	main	clean
PyAutoGalaxy	main	clean
autolens_workspace	main	clean
autogalaxy_workspace	main	clean
euclid_strong_lens_modeling_pipeline	main	test_report.md modified; unrelated

Suggested branch: feature/workspace-start-here-colab-links
Work classification: Both — library documentation and workspaces
Worktree root: ~/Code/PyAutoLabs-wt/workspace-start-here-colab-links/

Implementation Steps

1. Replace generic introductory links in PyAutoLens/README.md, docs/index.md, and paper/paper.md with <release>/start_here.ipynb.
2. Update the three introductory links in autolens_workspace/README.md.
3. Correct the matching link in euclid_strong_lens_modeling_pipeline/README.md, retaining its existing release pin.
4. Apply the equivalent changes to PyAutoGalaxy/README.md, docs/index.md, paper/paper.md, and autogalaxy_workspace/README.md.
5. Preserve imaging-specific links in the new-user guides and generated Markdown catalogues.
6. Confirm the root notebooks contain setup_colab.for_autolens(...) and setup_colab.for_autogalaxy(...).
7. Run a final scoped scan and link-target validation.

Key Files

• PyAutoLens/README.md
• PyAutoLens/docs/index.md
• PyAutoLens/paper/paper.md
• autolens_workspace/README.md
• PyAutoGalaxy/README.md
• PyAutoGalaxy/docs/index.md
• PyAutoGalaxy/paper/paper.md
• autogalaxy_workspace/README.md
• euclid_strong_lens_modeling_pipeline/README.md

Original Prompt

Click to expand starting prompt

The URL to this should not be imaging/start_here.py but the overall workspace start_here.py, The introduction Jupyter Notebook on Google Colab: try PyAutoLens in a web browser (without installation)., update it and scan other README.md and docs for the same issue

make sure the examples we are routing to has the right setup_colab

this is prob requied for PyautoGalaxy too

[Jammy2211]

Library PRs Created

• PyAutoLens: docs: link Colab introduction to workspace start #650 — 448 tests passed
• PyAutoGalaxy: docs: link Colab introduction to workspace start PyAutoGalaxy#523 — 1,006 tests passed

API changes: None — documentation links only.

Next: /start_workspace for the coordinated README updates in autolens_workspace, autogalaxy_workspace, and euclid_strong_lens_modeling_pipeline.

[Jammy2211]

Smoke Test Results — 2026-07-24

All 25 smoke tests passed across 3 workspaces.

Workspace	Passed	Failed	Skipped	Total
autolens_workspace	11	0	0	11
autogalaxy_workspace	8	0	0	8
euclid_strong_lens_modeling_pipeline	6	0	0	6

[Jammy2211]

Workspace PRs Created

• docs: link Colab introduction to workspace start autolens_workspace#331 — 11/11 smoke checks passed locally
• docs: link Colab introduction to workspace start autogalaxy_workspace#157 — 8/8 smoke checks passed locally
• docs: link Colab introduction to workspace start euclid_strong_lens_modeling_pipeline#36 — 6/6 smoke checks passed locally

All PRs carry the pending-release label and are cross-referenced from their upstream library PRs.

Required merge order

1. PyAutoLens docs: link Colab introduction to workspace start #650 and PyAutoGalaxy feat(weak): aplt plotters for WeakDataset shear catalogues (#496) #523
2. autolens_workspace feature/andrew implementation #331, autogalaxy_workspace Objects #157, and Euclid pipeline Spherical models use EllipticalProfile Geometry #36

The workspace PRs remain unmerged behind the library-first gate.

[Jammy2211]

Library PRs Merged

• PyAutoLens docs: link Colab introduction to workspace start #650 — merged as d231441f
• PyAutoGalaxy feat(weak): aplt plotters for WeakDataset shear catalogues (#496) #523 — merged as 3dd05d46

The library-first gate is now open. Euclid pipeline #36 is green; autolens_workspace #331 and autogalaxy_workspace #157 still have smoke checks in progress. No workspace PR has been merged yet.

[Jammy2211]

Shipped — 2026-07-24

PRs

• docs: link Colab introduction to workspace start #650 — merged
• docs: link Colab introduction to workspace start PyAutoGalaxy#523 — merged
• docs: link Colab introduction to workspace start autolens_workspace#331 — merged
• docs: link Colab introduction to workspace start autogalaxy_workspace#157 — merged
• docs: link Colab introduction to workspace start euclid_strong_lens_modeling_pipeline#36 — merged

Summary

Generic PyAutoLens and PyAutoGalaxy introduction links now open each workspace-root start_here.ipynb instead of the imaging-specific notebook. Explicit imaging tutorial links remain unchanged, and the pinned root notebooks were verified to contain the correct product-specific setup_colab calls.

Validation passed: 448 PyAutoLens tests, 1,006 PyAutoGalaxy tests, and workspace smoke totals of 11/11, 8/8, and 6/6.

Session Notes

The unrelated Euclid main-checkout change to test_report.md was preserved outside the task worktree.