Skip to content

pipeio docs_collect: index.md vs overview.md — duplicate "Overview" in nav

pipeio_docs_collect generates a stub index.md per flow ("# flow_name\n\nPipeline flow documentation.") AND collects the real overview.md from the flow-local docs. The generated nav YAML then has two "Overview" entries:

- preprocess_ecephys:
  - Overview: preprocess_ecephys/index.md    # stub
  - Overview: preprocess_ecephys/overview.md  # real content

Expected behavior: if a flow has docs/overview.md, use it as the index content (copy to index.md or alias in nav). Don't generate a stub alongside the real overview.

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