Skip to content

Fix docs_collect scripts.md links outside docs_dir

Goal

(promoted from note)

Context

(see source note)

Prompt

Fix pipeio docs_collect so that scripts.md files don't use relative links pointing outside the mkdocs docs_dir, which causes 30+ mkdocs warnings.

The bug: Auto-generated scripts.md uses links like ../../code/pipelines/{flow}/scripts/foo.py which resolve outside docs_dir.

Fix: Use plain code-formatted text for script paths instead of markdown links, since the scripts aren't browsable in mkdocs. Format as inline code (foo.py) or use the full path as text without a link.

Steps: 1. Read the docs_collect implementation in packages/pipeio 2. Find where scripts.md content is generated 3. Replace markdown links to script files with plain code-formatted text (e.g., script_name.py without a link) 4. Test with pipeio_docs_collect and verify no mkdocs warnings about links outside docs_dir

Acceptance Criteria

  • [ ]

Result

(pending)

Batch Result

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