Skip to content

pipeio docs_collect: scripts.md links point outside docs_dir — mkdocs warnings

The auto-generated scripts.md files use relative links like ../../code/pipelines/{flow}/scripts/foo.py to reference Python script files. These resolve to paths outside the mkdocs docs_dir, causing mkdocs WARNING on every script link (30+ warnings in pixecog build).

Options to fix: 1. Use plain text (no link) for script paths since they're not browsable in mkdocs 2. Use absolute URLs to the git repo (e.g., GitLab/GitHub file viewer) 3. Include script source as code blocks instead of links

Source context: pixecog

PixEcog (pixecog): Neuropixels and ECoG dataset and analysis

Recent commits: 

36f9326 Add result note directory and sample note
62841d9 Add questio YAML data model (questions.yml + milestones.yml)
9b2f6fa Scaffold ecephys TTL removal mod, flow overview + mod docs, demo notebook

README:

type: readme

Quick Start for Collaborators

Follow this checklist to get started with Pixecog documentation and workflows.

🐀 Pixecog Project — Compact Overview

Core principles

  • One immutable BIDS raw dataset (raw/) as the canonical baseline
  • Each analysis pipeline ha