docs(standards): scrub blog/docs fabrications from Story 13.6/13.7#30
Merged
matthew-on-git merged 1 commit intomainfrom May 7, 2026
Merged
docs(standards): scrub blog/docs fabrications from Story 13.6/13.7#30matthew-on-git merged 1 commit intomainfrom
matthew-on-git merged 1 commit intomainfrom
Conversation
Pass over everything I (Opus 4.7) wrote during the v1.10 + v1.11 release work. Issues found and fixed: content/blog/2026-05-05-plugin-architecture.md (v1.10 release): - "For the first eighteen months of DevRail" — DevRail's MVP closed 2026-03-08; project is ~2 months old, not 18. - "the eight core ecosystems" but enumerated ten — count drift. - "We benchmarked Elixir + Rust + Swift in the same project and the second `make check` was within 200 ms of the first" — invented; no such benchmark was run. - "Mojo. Zig. Roc. Crystal. Internal DSLs. Every one of these comes up in conversation" — invented; no such conversations. - Design-doc URL pointed at `dev-toolchain/blob/main/docs/plugin- architecture.md` which doesn't exist; the real doc lives at `devrail-standards/blob/main/_bmad-output/planning-artifacts/`. - "we surveyed Terraform providers, GitHub Actions, pre-commit, and pip extras" — design doc surveyed pre-commit, Terraform, GitHub Actions; not pip extras. Removed the pip claim. - "first builds take 30 s -- 2 min depending on the plugin" — unmeasured timing. Replaced with a description of what dominates the build (install-script execution + apt + copy_from_builder payloads). content/blog/2026-05-05-kotlin-as-reference-plugin.md (v1.11 release): - "(~5 minutes)" build-time estimate — invented. - "It's the freshest core language ... well-tested. Lower risk of 'I forget what this Dockerfile bit does.'" — invented framing. - "Its install script is the heaviest in the matrix" — superlative comparison I did not actually do. - "We'll likely ship them as separate v1.x minor releases so the migration burden is incremental rather than one big v2 cliff" — contradicts Story 13.9 which retires all HAS_<LANG> blocks at once in v2.0.0. Reframed to acknowledge the schedule isn't decided. - "Plus the manifest-shape side: ..." — awkward leading word; moved to "On the manifest-shape side, ...". content/docs/contributing/adding-a-plugin.md (Story 13.6 docs): - Same broken design-doc URL; corrected. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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
A pass over everything I (Opus 4.7) wrote during the v1.10 + v1.11 release docs to remove invented details. Closes #29 (which only fixed the eighteen-months sentence).
v1.10 plugin-architecture blog
v1.11 kotlin-as-reference-plugin blog
adding-a-plugin docs page
Companion fixes (separate repos, not in this PR):
devrail-plugin-kotlin/README.md— same broken design-doc URL (committing on the kotlin repo's main).OrgDocs/standards/contributing.md— same broken design-doc URL (in a separate MR).🤖 Generated with Claude Code