Skip to content

Fix docs_collect missing notebook index.md

Goal

(promoted from note)

Context

(see source note)

Prompt

Fix pipeio docs_collect to generate an index.md landing page for the notebooks/ directory when a flow has published notebooks.

The bug: docs_collect creates nav entries for individual notebook HTML files in docs/pipelines/{flow}/notebooks/ but does not generate a notebooks/index.md. This causes mkdocs warnings about unrecognized relative links.

Fix: When collecting notebooks for a flow, generate a notebooks/index.md that lists the available notebooks with links.

Steps: 1. Read the docs_collect implementation in packages/pipeio 2. Find the notebook collection logic 3. Add generation of a notebooks/index.md listing available notebooks for each flow 4. Ensure the nav YAML points to the index correctly 5. Test with pipeio_docs_collect

Acceptance Criteria

  • [ ]

Result

(pending)

Batch Result

  • status: done
  • batch queue_id: 59776a5fb063
  • session: c1af094a-dd1c-44f6-ad61-3614f23dfd39
  • batch duration: 357.5s