docs: full-corpus /n vs /mnt placement sweep + orphaned-commit recovery - #519
Merged
Merged
Conversation
The Go-to-Dis compiler is experimental and nothing is built from it; presenting Go as a repo language invites agents to write Go for InferNode features. AGENTS.md now states application code is Limbo, never other languages; the GoDis contribution section, directory-table row, and index section are removed. The pedagogical uses stay — 'Limbo is close to Go' is orientation, not an invitation. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017Eo29oZp7mPig1XekwRPsq
The doc predates NAMESPACE-LAYOUT.md and demonstrated every example service at /n/* — app-authored schemas that belong under /mnt by the schema-authorship rule. All 23 example paths converted, and a new 'Where to mount it' section states the principle up front (authored schema -> /mnt even when data is remote; foreign tree imported intact -> /n; the convention is security work; legacy /n/wallet and /n/git are not to be copied) with the full argument deferred to NAMESPACE-LAYOUT.md. Same inherited idiom fixed in DESIGN-PRINCIPLES' worldview example (/n/sensors -> /mnt/sensors) and USER-MANUAL's philosophy tenet (/n/web -> /mnt/web, where webfs actually lives). Index description of the conventions doc generalized. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017Eo29oZp7mPig1XekwRPsq
…sified Two agents examined every /n/ occurrence across docs/ (112 files), man/ (all sections), docs subdirs, appl/**/*.md, lib/veltro text, and root docs, against NAMESPACE-LAYOUT.md's schema-authorship rule. Fixed: man/4/web9p (13x /n/web -> /mnt/web — documents an app-authored schema; its stated source appl/cmd/web9p.b does not even exist) and appl/xenith/IDEAS.md's web9p proposal (9x). Everything else classified: live legacy paths kept accurate (/n/wallet, /n/git, /n/wikia, /n/speech — now annotated in DESIGN-PRINCIPLES and 9p-data-conventions with their migration tickets INFR-400..403), genuine imports kept (/n/local, peer roots, device trees), historical records left untouched. Also carries the re-cut of two commits orphaned by the #518 merge: the Go removal from the contributor surface and the 9p-data-conventions /mnt example conversion. Refs: INFR-400, INFR-401, INFR-402, INFR-403 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017Eo29oZp7mPig1XekwRPsq
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Per maintainer direction: sweep all 100+ docs so placement confusion can't spread, with every
/n/occurrence classified rather than blanket-replaced.Classification discipline (NAMESPACE-LAYOUT.md is the authority):
/n:man/4/web9p(13×; documents a service whose stated sourceappl/cmd/web9p.bdoesn't exist — flagged below) andappl/xenith/IDEAS.md's web9p proposal (9×). Plus, recovered from the post-docs: exemplar audit + entry-point hardening #518-merge orphan commits: the 9p-data-conventions example conversion (23 paths + "Where to mount it" section) and the Go removal from the contributor surface./n/wallet,/n/git,/n/wikia,/n/speech): the code really mounts there today, so docs stay truthful; DESIGN-PRINCIPLES and 9p-data-conventions now cite their migration tickets INFR-400–403./n/local(host fs), peer exported roots (/n/remote,/n/tbl4,/n/macaudio), device trees, mntgen.Full classification tables are in the commit's agent reports; zero occurrences were left unexamined.
Findings for follow-up, not addressed here:
man/4/web9pdocuments a service that was never implemented — candidate for retirement or a rewrite against the realwebfs.appl/cmd/webfs.b:160still defaultsmountpt := "/n/web"although the tree treats/mnt/webas canonical — fixed in the companion INFR-401 migration PR.Testing
Docs/man/text only; no code or bytecode changes.
🤖 Generated with Claude Code
https://claude.ai/code/session_017Eo29oZp7mPig1XekwRPsq