Skip to content

Move the package overview to the start of its chapter - #43

Open
fingolfin wants to merge 1 commit into
masterfrom
mh-ai/autodoc-intro-placement
Open

fingolfin wants to merge 1 commit into
masterfrom
mh-ai/autodoc-intro-placement

Conversation

@fingolfin

Copy link
Copy Markdown
Member

Upcoming AutoDoc versions (gap-packages/AutoDoc#390) warn about plain text that AutoDoc discards, or that the manual shows inside a preceding section because it is added to the chapter after that section. Here, the overview text in gap/walrus.gd ended up at the end of section "Examples" of chapter "Overview", because gap/examples.gd is read first. Moving it to doc/Intros.autodoc puts it at the start of the chapter.

AI disclosure: prepared with Claude Code, which found the cause, wrote the change, and checked that the manual builds without warnings.

🤖 Generated with Claude Code

gap/examples.gd is read before gap/walrus.gd and creates the section
"Examples" in the chapter "Overview". The overview text in
gap/walrus.gd therefore ended up at the end of that section. Moving
it to doc/Intros.autodoc puts it before the first section, and avoids
a warning from upcoming AutoDoc versions.

Assisted-by: Generative AI
@codecov

codecov Bot commented Nov 10, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 90.12%. Comparing base (88ce719) to head (9579e55).

Additional details and impacted files
@@           Coverage Diff           @@
##           master      #43   +/-   ##
=======================================
  Coverage   90.12%   90.12%           
=======================================
  Files          22       22           
  Lines        2370     2370           
=======================================
  Hits         2136     2136           
  Misses        234      234           
Files with missing lines Coverage Δ
gap/walrus.gd 100.00% <ø> (ø)
🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

This branch has not been deployed

No deployments
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.

1 participant