Skip to content

docs(readme): overhaul README for v1 branch#421

Open
wryonik wants to merge 5 commits intov1from
us/v1-readme-overhaul
Open

docs(readme): overhaul README for v1 branch#421
wryonik wants to merge 5 commits intov1from
us/v1-readme-overhaul

Conversation

@wryonik
Copy link
Copy Markdown
Collaborator

@wryonik wryonik commented Apr 23, 2026

Summary

Replaces the flat demo-instructions README on the v1 branch with a structured, professional document using the same conventions applied to main in #420.

  • Quick links row under the header (Getting Started, Examples, Contributing, Issues)
  • Mermaid architecture diagram and crate table
  • End-to-end ## Example section using noir-examples/basic-4 — all four commands (nargo compileprepareproveverify) verified locally with nargo v1.0.0-beta.11
  • Getting Started as collapsible steps
  • Profiling as a table (Tool / Measures / Command)
  • Acknowledgements section explaining what each dependency contributes to ProveKit, grounded in the source code
  • No banner image (no assets/ on this branch)

v1-specific correctness fixes included:

  • generate-gnark-inputs uses ./prover.pkp (v1 CLI takes the prover key, not verifier key)
  • Noir version pinned to v1.0.0-beta.11
  • No --compiler mavros option (not present in v1 CLI)
  • Skyscraper described as BN254, not M31/CM31

Test plan

  • nargo compile on noir-examples/basic-4 — clean with v1.0.0-beta.11
  • Full prepareproveverify pipeline — exit code 0

Replaces the flat demo-instructions README with a structured, technical
document following the same conventions as the main branch overhaul.

- Add quick links row (Getting Started, Examples, Contributing, Issues)
- Add Mermaid architecture diagram and crate table
- Add end-to-end Example section using noir-examples/basic-4 — all four
  commands verified locally with nargo v1.0.0-beta.11
- Structured Getting Started as collapsible steps
- Profiling section as a table with Tool / Measures / Command columns
- Acknowledgements section explaining what each dependency contributes
- Fix generate-gnark-inputs to use prover.pkp (correct for v1 CLI)
- Fix skyscraper description: M31/CM31 -> BN254
@wryonik wryonik requested a review from Bisht13 April 23, 2026 00:10
wryonik added 4 commits April 23, 2026 10:55
Remove filler intro from Acknowledgements, break the uniform capitalisation
pattern in dependency bullets, add explicit nargo version pin, and replace
the ### Circuit inspection heading with a contextual prose line.
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