Public-readiness (1/3): welcome-first README, reader guide, about doc - #71
Merged
Conversation
Rewrite the root README for non-technical guests: a short welcome with Blima's biscotti, then clear paths to read the cookbook (download + install guide), browse recipes (by category or tag), the BlimaCake story, and plain-language rights. Move the technical/provenance/tooling detail into docs/about-this-archive.md so it stays available without crowding the front page. Add docs/read-the-cookbook.md, a step-by-step guide to opening BlimaCake.epub on Apple Books, Kindle, Kobo, Google Play Books, and other readers. Align the NOTICE contact to jeff@posluns.ca. Co-authored-by: Claude <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HpG2vky2XhDtfc6y16TRis
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.
First of a few PRs to make the repo welcoming for non-technical guests before it goes public.
Root README, rewritten for guests
Now opens with a short welcome and Blima's biscotti photo, then three clear paths:
BlimaCake.epub(or via Releases) + link to the new install guide.All the archival/technical material (WXR import, provenance, tools, roadmap, governance) moved out of the front page into a new doc so it stays available without confronting a casual reader.
New docs
docs/read-the-cookbook.md— step-by-step instructions for Apple Books, Kindle (Send to Kindle, verified current), Kobo, Google Play Books, and other readers, plus "what is an EPUB / where do I download it".docs/about-this-archive.md— the moved-out "how this was made" content (scope, structure, provenance, curation, the e-book build, contributing/governance).Also
NOTICE.mdcontact aligned tojeff@posluns.ca(matches the ebook and README).Notes / still to come
recipes/README.md, category pages,tags.md) friendlier and add a navigation breadcrumb to every recipe page.Dash-guard and markdownlint clean.
🤖 Generated with Claude Code
Generated by Claude Code