Skip to content

docs: root README monorepo map + stale package-doc audit#69

Open
pablo-rerun wants to merge 2 commits into
mainfrom
monorepo-docs-audit
Open

docs: root README monorepo map + stale package-doc audit#69
pablo-rerun wants to merge 2 commits into
mainfrom
monorepo-docs-audit

Conversation

@pablo-rerun

Copy link
Copy Markdown
Collaborator

What

Documentation-only pass over the monorepo (split out of #68, which keeps the gsplat-specific docs):

  • Root README.md rewritten as a 2-minute orientation: Pixi workspace model, a verified 3-step quick start (install pixi → install one dev env → run its demo), optional direnv workflow, a complete 25-package index, and the env/task/--frozen conventions.
  • AGENTS.md corrected to distinguish runnable, build-only, vendored, and docs-only packages instead of treating every directory as a runnable Python package.
  • 11 package READMEs fixed against the actual pixi.toml: wrong/missing -e <env> flags (dpvo, mv-api, prompt-da, sam3, sam3d-body, robocap-slam), dead file references (mamma), wrong build claims (mast3r-slam: Mojo not CUDA kernels), obsolete prerelease pin claims (simplecv → rerun-sdk==0.34.1), stale platform warnings (slam-evals), and nonexistent abbreviated task names (wilor-nano).

Verification

Every claim added or kept was checked against pixi task list, the [environments] table, or the file tree. Ambiguous items (external clone instructions, PyVRS sensor-count wording) were deliberately left unchanged. Known gaps not addressed here: asmk has no run command documented, dpretrieval has no README.

🤖 Generated with Claude Code

Root README rewritten as a 2-minute orientation: what the Pixi workspace is,
a verified 3-step quick start, optional direnv workflow, a complete
25-package index, and the env/task/--frozen conventions. AGENTS.md corrected
to distinguish runnable, build-only, vendored, and docs-only packages.
Eleven package READMEs fixed against actual pixi.toml tasks, environments,
and paths (wrong env flags, dead links, renamed tasks, obsolete prerelease
claims). Every remaining claim was checked against the task list or file
tree; ambiguous items were left alone.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@pablo-rerun

Copy link
Copy Markdown
Collaborator Author

@copilot resolve the merge conflicts in this pull request

Copilot AI commented Jul 19, 2026

Copy link
Copy Markdown

@copilot resolve the merge conflicts in this pull request

Resolved the merge conflicts by merging origin/main into this branch and fixing the README.md conflict in commit e37b7c9.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants