docs(claude-md): the linking example published one machine's home directory
org-ops census sweep 07 flagged CLAUDE.md:56 as LINK-FILE-URL (ERROR): the example link carried file:///Users/ktg/..., which is dead for every reader but the author and publishes the operator's directory layout on a public surface. The rule itself is unchanged — absolute file:// paths with a descriptive name are still what a response should use. Only the example is now a placeholder, with a note saying why it has to stay one. Note for the verify step: 'grep -n file:///' over this file cannot go empty by construction — line 48 specifies the link syntax and must contain the literal. The distinguishing check is 'grep -n file:///Users/', which is now empty.
This commit is contained in:
parent
fcfaee4589
commit
72de0e0c15
1 changed files with 3 additions and 2 deletions
|
|
@ -51,6 +51,7 @@ When pointing to local files in responses, always use markdown link syntax with
|
|||
|
||||
Why: bare `file://` URLs only render the first as clickable across multiple lines. Named markdown links make each entry independently clickable and look cleaner.
|
||||
|
||||
Example:
|
||||
Example (the path is a placeholder — the checkout root is the reader's own, and
|
||||
this file is published, so it must not carry one machine's directory layout):
|
||||
|
||||
- [Brief](file:///Users/ktg/repos/llm-ingestion-pipeline-security/docs/BRIEF.md)
|
||||
- [Brief](file:///absolute/path/to/llm-ingestion-pipeline-security/docs/BRIEF.md)
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue