Skip to content

Problem

questio_docs_collect generates _generated/index.md with a backlog link [Backlog](../log/result/index.md). With the new _generated/ layout (docs_dir: _generated in plan/mkdocs.yml), this relative path resolves to plan/log/result/index.md which doesn't exist — the log sub-site is at docs/log/.

In a monorepo layout, cross-sub-site links cannot use relative paths. They need to use absolute paths (e.g., /log/result/index.md) or wikilinks.

Fix

The backlog link in the plan index template should use an absolute path (/log/result/index.md) rather than a relative path. Same applies to any other questio-generated links that cross sub-site boundaries (e.g., evidence links to result notes).

Workaround

Manual sed on generated file: sed -i 's|\.\./log/result/index\.md|/log/result/index.md|'

Source context: pixecog

PixEcog (pixecog): Neuropixels and ECoG dataset and analysis

Recent commits: 

8dc0d9d Pipeline docs: gitignore docs/pipelines/, relocate hand-authored files
96cd1ec Refactor sharpwaveripple/contracts: extract generic helpers to utils/io, remove pipelines __init__.py
36f9326 Add result note directory and sample note

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