docs: sync README and CLAUDE.md with current feature set - #8
Merged
Conversation
README was missing shortcodes, the console (theme/music commands), and colour themes entirely, and still listed Hugo 0.116 as the minimum even though the repo/package cards now use the try keyword (0.141+). Add sections for all of it and bump the version note. hello-world had grown into a shortcode kitchen sink once shortcodes.md existed as the real reference — trimmed back to its original job (prose and typography demo), with a pointer to the new reference post. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01K5qPo8jfbbrvWKrWQyZ8iK
Add a Shortcodes section covering the positional/named param gotcha (bit us twice), the shared .repo-card component, the try-based build-time fetch pattern, the fail-soft-vs-fail-loud split, and why mailto is the one shortcode that ships JS. Also fixes the stale "no JS dependencies" and "Hugo 0.116" claims, both now inaccurate. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01K5qPo8jfbbrvWKrWQyZ8iK
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
try, added in 0.141).hello-world.md: trims the kitchen-sink shortcode demo back to a plain prose/typography post now thatshortcodes.md(docs: shortcode reference post #7) is the real reference, with a pointer to it.CLAUDE.md: new Shortcodes section — positional/named param mixing gotcha (bit us twice), shared.repo-cardcomponent,try-based build-time fetch pattern, fail-soft-vs-fail-loud convention, whymailtois the one shortcode that ships JS. Fixes the same stale "no JS"/"Hugo 0.116" claims.These two commits were originally queued behind #7 but that PR got merged before they landed, so they're split out here.
Test plan
pnpm buildclean🤖 Generated with Claude Code
https://claude.ai/code/session_01K5qPo8jfbbrvWKrWQyZ8iK