docs: strip internal PR/issue numbers and process tells from blog prose#882
Draft
vivek7405 wants to merge 1 commit into
Draft
docs: strip internal PR/issue numbers and process tells from blog prose#882vivek7405 wants to merge 1 commit into
vivek7405 wants to merge 1 commit into
Conversation
Inline #NNN tracking references read as commit chatter to a blog reader,
who has no context for a PR number, and an author's verification process
("Verified by dogfooding") does not belong in published copy. Remove
every #NNN from blog bodies (rewording each sentence to flow, or dropping
the sentence where the number was its whole point) and the one process
tell, across 16 posts. The established rhetorical voice (the "Let me show
you..." openers from the original posts) is preserved.
Closes #881
vivek7405
commented
Jul 9, 2026
vivek7405
left a comment
Collaborator
Author
There was a problem hiding this comment.
Read every reworded hunk. The prose reads clean, no dangling clauses or orphaned transitions where a trailing sentence was dropped, and every version number, runtime name, and API name survived the number-stripping. The 'Let me show you' voice is intact. Every removal was a tracking pointer or pure history, not a fact a reader needs. Ready to merge.
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
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.
Blog posts carried inline internal tracking references (
#605,#646,#489, ...) that read as commit chatter to a reader, plus one process tell ("Verified by dogfooding") that leaks the author's verification workflow into published copy. Neither belongs in a blog.Closes #881
What changed
#NNNfrom blog bodies across 16 posts, rewording each sentence to read naturally (or dropping the sentence entirely where the number was its only content, e.g. "It landed in Elide page/layout modules that ship only to import interactive components #605 and feat: elide page/layout modules that only import components #609.").per-action-middleware.md.import-only-pages-zero-js.mdparagraph so it reads as clean prose.What was deliberately kept
#NNNrefs elsewhere (agent-docs/,AGENTS.md, docs site) are untouched; onlyblog/*.mdchanged.Verification
git grep -nE '#[0-9]{3,4}' -- 'blog/*.md'returns nothing.src), so the doc/scaffold/test gates do not apply.