Skip to content

Curation Inventory Status

This page records durable inventory findings from the consolidated-docs curation workflow so future sessions can recover the current posture without re-running discovery from scratch.

Current Snapshot

Inventory source:

  • scripts/curation_inventory.py

Manifest source of truth:

  • curation/curated-doc-sites.yml

Most recently persisted inventory interpretation:

  • assessed repos: 30
  • curated repos: 22
  • non-curated candidates: 8
  • manifest changes applied during that run: none

Current Curated Risk Posture

Curated repos currently assessed as fail by the inventory tool:

  • content-workflow
  • dirac-framework
  • npi_news
  • oves-hard-tech
  • oves-sites

Curated repos currently assessed as warn make up most of the remaining curated set.

The inventory run did not produce any pass repos.

Common Findings

Repeated issues across curated repos currently include:

  • missing .docs-template-info.json
  • missing hooks/build_semantic_registry.py
  • missing hooks/update_date.py in many repos
  • missing extra.oves_hub_integration.enabled for curated repos
  • site_name and home-page H1 mismatch in many repos

Additional repo-specific hard failures included:

  • YAML parse failures in some repos
  • unresolved merge-conflict markers in npi_news
  • missing docs/index.md in some repos under the current tool assumptions

Candidate Repos Outside Current Curation

The current inventory surfaced these non-curated candidates:

  • Powernotes
  • agentic-programs
  • dirac-abs-archive
  • dirac-uxi
  • mkdocs-template
  • oves-access-management
  • uxi-landing

These are candidates detected by the tool, not approved additions to curation.

Known Inventory Tool Limitation

The current inventory tool assumes a single-language repo shape that includes:

  • docs/index.md

That assumption is not correct for multilingual template repos such as mkdocs-template, which use localized entry pages like:

  • docs/index.md
  • docs/fr/index.md
  • docs/zh/index.md

As a result, the tool can incorrectly mark a multilingual repo as fail even when it is structurally valid for the template standard.

Interpretation Rule

Use the inventory output as an operational review signal, not as an infallible truth source. In particular:

  • curated membership still comes from the manifest
  • inventory warn and fail are assessment outputs, not automatic removal
  • multilingual/template repos must be interpreted with the known limitation in mind until the tool is improved

Next Improvement Target

The next structural improvement for this workflow is to make scripts/curation_inventory.py template-aware so it recognizes multilingual entry-page layouts and evaluates template-conformant repos correctly.