Skip to content

Rewrite README and add architecture + contributing docs - #3

Merged
Vinald merged 1 commit into
mainfrom
docs/project-documentation
Sep 9, 2026
Merged

Vinald merged 1 commit into
mainfrom
docs/project-documentation

Conversation

@Vinald

@Vinald Vinald commented Sep 8, 2026

Copy link
Copy Markdown
Owner

Documents the repo.

Changes

  • README.md — full rewrite: feature table, getting-started + toolchain notes, an lib/ tree with a one-line purpose per file, data-flow summary, "adding a template", dependency notes (the file_magic_number override, web pdf.js pinning, fonts), testing + CI, and a short known-limitations list.
  • docs/ARCHITECTURE.md (new) — layer-by-layer walkthrough: models (defensive JSON, copy-on-edit), persistence + the in-memory storage fallback, PdfTheme/templates/PdfComponents, the LaTeX escape + token-substitution engine, the hand-built DOCX zip, the UI/provider wiring, and the test injection seams.
  • CONTRIBUTING.md (new) — setup, the analyze + test gate, commit/branch conventions, a "where things live" table, pointer to REVIEW.md.
  • .gitignore — ignore devtools_options.yaml (was showing up untracked).

Docs only. flutter analyze clean.

Cross-references REVIEW.md from PR #1 and the placeholder persona from PR #2.

🤖 Generated with Claude Code

@Vinald
Vinald merged commit 6c47537 into main Sep 9, 2026
2 checks passed
@Vinald
Vinald deleted the docs/project-documentation branch September 9, 2026 05:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant