Skip to content

Detect guide/ and guides/ as documentation directories - #12

Merged
Nayjest merged 1 commit into
mainfrom
guide-docs-dir
Aug 28, 2026
Merged

Detect guide/ and guides/ as documentation directories#12
Nayjest merged 1 commit into
mainfrom
guide-docs-dir

Conversation

@Nayjest

@Nayjest Nayjest commented Aug 28, 2026

Copy link
Copy Markdown
Member

Closes #11.

wasm-bindgen's maintainer reported (wasm-bindgen/wasm-bindgen#5291, comment) that the report claims the repository has no documentation directory while a full mdBook lives under guide/. DOC_DIR_NAMES only matched doc, docs, documentation and wiki.

  • collect.py: add guide and guides to DOC_DIR_NAMES — the same widening that added documentation/ and wiki/ (workspace#24).
  • docs/report-schema.md: the documented name list follows.
  • tests/test_signals.py: the alias test covers the two new names.
  • Release prep: 0.13.0, changelog entry with downstream impact (pin bump only; no new report field, no METRICS_VERSION change — affected repositories pick the signal up at their next rescan).

wasm-bindgen keeps its documentation as an mdBook under guide/ — the
established convention in the Rust ecosystem — yet scored 0/25 on the
Documentation directory criterion, which its maintainer pointed out
after merging the badge PR. Widen DOC_DIR_NAMES the same way
documentation/ and wiki/ were added before.

Closes #11
@Nayjest
Nayjest merged commit 6401eb7 into main Aug 28, 2026
2 checks passed
@Nayjest
Nayjest deleted the guide-docs-dir branch August 28, 2026 19:21
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.

guide/ directories are not recognized as documentation

1 participant