Skip to content

docs: Clarify scan_dirs behavior#345

Merged
fingolfin merged 1 commit intomasterfrom
codex/scan-dirs-docs
Mar 11, 2026
Merged

docs: Clarify scan_dirs behavior#345
fingolfin merged 1 commit intomasterfrom
codex/scan-dirs-docs

Conversation

@fingolfin
Copy link
Member

Clarify in both the tutorial and reference manual that
autodoc.scan_dirs controls scanning for AutoDoc source comments
and .autodoc files, while gapdoc.scan_dirs only controls scanning
for GAPDoc comments. This also corrects the tutorial examples to
use the autodoc record for the documented behavior.

Fixes #263

AI assistance was provided by Codex for reviewing the existing
documentation, drafting the wording changes, and updating the
generated manual fixtures.

Co-authored-by: Codex codex@openai.com

Clarify in both the tutorial and reference manual that
autodoc.scan_dirs controls scanning for AutoDoc source comments
and .autodoc files, while gapdoc.scan_dirs only controls scanning
for GAPDoc comments. This also corrects the tutorial examples to
use the autodoc record for the documented behavior.

Fixes #263

AI assistance was provided by Codex for reviewing the existing
documentation, drafting the wording changes, and updating the
generated manual fixtures.

Co-authored-by: Codex <codex@openai.com>
@codecov
Copy link

codecov bot commented Mar 11, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 91.65%. Comparing base (a94e025) to head (030a120).
⚠️ Report is 2 commits behind head on master.

Additional details and impacted files
@@           Coverage Diff           @@
##           master     #345   +/-   ##
=======================================
  Coverage   91.64%   91.65%           
=======================================
  Files          13       13           
  Lines        2597     2600    +3     
=======================================
+ Hits         2380     2383    +3     
  Misses        217      217           
Files with missing lines Coverage Δ
gap/Magic.gd 100.00% <ø> (ø)

... and 1 file with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@fingolfin fingolfin merged commit 9f81472 into master Mar 11, 2026
8 checks passed
@fingolfin fingolfin deleted the codex/scan-dirs-docs branch March 11, 2026 17:32
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.

The usage of scan_dirs is incorrectly documented

1 participant