Skip to content

## Monorepo `

Monorepo !include pattern for notio log nav

Task

Replicate pipeio's monorepo pattern for the Log section (notio notes):

  1. log_nav() in notio — auto-generate docs/log/mkdocs.yml:
  2. Scan docs/log/ subdirectories for note types (daily, weekly, meeting, idea, issue, commit, etc.)
  3. Each type with an index.md gets a nav entry
  4. Write standalone mkdocs.yml with site_name: "log", docs_dir: ., and hierarchical nav

  5. Root mkdocs.yml gets - Log: '!include ./docs/log/mkdocs.yml'

  6. This replaces the currently hardcoded Log nav block in root mkdocs.yml (which lists each note type statically). New note types added via notio would appear automatically.

  7. Extend _sync_mkdocs_monorepo() in projio/sync.py to handle log includes.

Reference

  • Pipeio pattern: packages/pipeio/src/pipeio/docs.py:310-385 (docs_nav())
  • Pixecog mkdocs.yml Log section (lines 98-105) shows the static nav being replaced
  • Note types come from notio's .templates/ directory or scanning docs/log/ subdirs