docs: implement Kovina Repository Standard#82
Merged
Conversation
Apply the Kovina Repository Standard to OpenReader, transforming the repository into a product showcase for end users and recruiters. ### Repository Structure - assets/ reorganized: hero/, screenshots/, icons/, branding/ - docs/ created: Architecture.md, Deployment.md, Testing.md, Contributing.md - Root docs moved to docs/: RELEASE.md, VERSIONING.md, SUPPORT.md, ARCHITECTURE.md, ROADMAP.md, PRIVACY.md - CONTRIBUTING.md updated to point to docs/Contributing.md - .gitignore updated with .wrangler/ exclusion - AGENTS.md and CLAUDE.md updated with new doc paths ### New Assets - 12 Kovina-style feature SVG icons (48x48, 1.5px stroke) - 8 tech stack SVG icons - OpenReader app icon SVG - All icons in assets/icons/ per standard ### README (11-section Kovina standard) 1. Hero — logo, tagline, large hero screenshot 2. Primary CTA — Store, Release, Website, Source Code badges 3. Gallery — Dark mode, PDF tools, about dialog, sample doc 4. Why OpenReader — 4 value propositions 5. Features — Two-column grid with Kovina SVG icons 6. Designed For — 5 audience segments 7. Design Philosophy — Quote + philosophy paragraph 8. Built With — Icon row (8 tech icons) 9. Version Journey — Timeline from v0.1.0 to v1.2.4 10. License — AGPLv3 + CTA badges 11. Part of the Open Collection — 9 Open* apps with links ### Standard Document - docs/playbooks/KOVINA_REPOSITORY_STANDARD.md — reusable spec for all Kovina repositories covering structure, section order, assets, icons, and quality checklist Co-Authored-By: Claude <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.
Kovina Repository Standard
Transform OpenReader's repository into a premium software product showcase following the new Kovina Repository Standard — a reusable specification for all Open* projects.
README (11-section layout)
New Asset Structure
New Documentation
docs/Architecture.md— System architecturedocs/Deployment.md— CI/CD and distributiondocs/Testing.md— Test suite and quality gatesdocs/Contributing.md— Contributor guidedocs/playbooks/KOVINA_REPOSITORY_STANDARD.md— Reusable standardCleanup
docs/(ARCHITECTURE, RELEASE, VERSIONING, SUPPORT, ROADMAP, PRIVACY)docs/Contributing.md.gitignoreupdated