chore: vendor humanizer and add a humanize-docs skill - #153
Merged
Merged
Conversation
Vendors blader/humanizer (MIT) unmodified at 9862685f, the same copy rommapp/romm uses, and excludes it from Trunk so it stays byte-identical to upstream. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XXuG7JWgxP6DPLB182yD9v
Applies the vendored humanizer to the prose a change adds under docs/, skipping snippet partials and the nav file, and keeping headings (anchor targets), front matter, MkDocs syntax and UI labels as written. Ends with trunk and a strict mkdocs build. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XXuG7JWgxP6DPLB182yD9v
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
2 participants
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.
Adds blader/humanizer and a small skill that runs it over the pages a change edits, as the last step before opening a PR. The main repo (rommapp/romm) uses the same vendored copy.
.claude/skills/humanizer/: upstreamSKILL.mdandLICENSE(MIT), unmodified at9862685f(v3.0.0).UPSTREAMrecords the commit and how to update it..trunk/trunk.yaml: all linters skip that folder, so it stays byte-identical to upstream..claude/skills/humanize-docs/: run with/humanize-docs, optionally with page paths. With no arguments it takes every page underdocs/that differs frommainand rewrites only the changed paragraphs. It leaves these as written:Navigation.mdIt finishes with
trunk fmt && trunk checkandmkdocs build --strict.Testing:
docs/index.mdand skips an edited snippet.docs/**/*.mdwould have missed top-level pages such asdocs/index.md, so the skill usesdocs/*.md. The link-check job inpr-checks.ymluses the**form and has the same gap. This PR doesn't change it.trunk.yaml. Prettier already flaggedtrunk.yamlbefore this change.mkdocs builddidn't run in my environment: the Trunk installer and the Google Fonts download were blocked by network policy. CI runs both.AI assistance: Claude Code wrote this PR, including the skill text and the vendoring. A human asked for the change and chose where humanizer runs.
🤖 Generated with Claude Code
https://claude.ai/code/session_01XXuG7JWgxP6DPLB182yD9v
Generated by Claude Code