Skip to content

docs: restructure READMEs, add CONTRIBUTING and LICENCE#107

Open
rin-st wants to merge 1 commit into
mainfrom
fix-reamdes-and-contributing
Open

docs: restructure READMEs, add CONTRIBUTING and LICENCE#107
rin-st wants to merge 1 commit into
mainfrom
fix-reamdes-and-contributing

Conversation

@rin-st

@rin-st rin-st commented May 7, 2026

Copy link
Copy Markdown
Member

Summary

Closes #30. Pass over READMEs, contributing guide, and LICENCE.

  • Root README — overview + packages table + quick start, no longer dev-instructions only. Not rendered on npm, so it's purpose-built for GitHub.
  • CONTRIBUTING.md — new. Absorbs the local dev workflows (example app + Scaffold-ETH 2 setup) that used to live in the root README, plus changeset / lint / format / docs editing.
  • Package READMEs — consistent shape across components / hooks / debug-contracts: tagline → install (npm + yarn + pnpm) → minimal example → link to the corresponding docs install page.
  • example/README.md — replaced create-next-app boilerplate with a one-liner pointing at CONTRIBUTING.
  • Docs site — new /debug-contracts installation page mirroring /components and /hooks, wired into the sidebar and the landing page.
  • LICENCE — added at the root (MIT, matching scaffold-eth-2's BuidlGuidl attribution and LICENCE spelling). Added "license": "MIT" to all three published packages' package.json and a patch-bump changeset for it.

Test plan

  • pnpm install and pnpm dev still work (no behavioral changes, just metadata)
  • Render the root README on GitHub — relative links resolve to packages, CONTRIBUTING, LICENCE
  • Render package READMEs on npm preview — install snippets show npm/yarn/pnpm; doc links go to install pages
  • cd docs && pnpm dev/debug-contracts renders the new installation page; sidebar shows the new entry
  • Confirm BuidlGuidl is the right copyright holder

- Root README: overview + package list + quick start, no more dev instructions
- New CONTRIBUTING.md absorbs local dev workflows (example app + Scaffold-ETH 2)
- Slim package READMEs to install (npm/yarn/pnpm) + minimal example + docs link
- New /debug-contracts installation page in the docs site, wired into sidebar
- Add MIT LICENCE at root and license field on published packages
- Replace example/README.md create-next-app boilerplate

Closes #30

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@vercel

vercel Bot commented May 7, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
scaffold-ui-docs Ready Ready Preview, Comment May 7, 2026 3:35pm
scaffold-ui-example Ready Ready Preview, Comment May 7, 2026 3:35pm

Request Review

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.

READMEs and Contributing guide

1 participant