Skip to content

docs: put name-claiming front and center; ship a README with the placeholder - #18

Merged
theoephraim merged 2 commits into
mainfrom
docs/claim-a-name-upfront
Sep 17, 2026
Merged

theoephraim merged 2 commits into
mainfrom
docs/claim-a-name-upfront

Conversation

@theoephraim

Copy link
Copy Markdown
Member

Summary

  • README now leads with a Just claim a name section right under the demo gif: npm login + npx fledgling add <name> --new --yes from any directory, plus the --skip-trust variant for claiming everything in an existing repo. The intro paragraph lists name-claiming and trusted-publishing sync as two jobs you can use independently, and the buried "Just want to claim names?" subsection now links up to the new section.
  • The placeholder package published to claim a name now ships a README.md (alongside the package.json) so the npm page says what it is: claimed with fledgling (linked), links the package's own repo/homepage when the manifest has one, notes there's nothing to install yet, and closes with the same one-liner.

Test plan

  • bun run typecheck and bun run build pass
  • Rendered placeholderReadme() for a bare name and for a manifest with repository; both read correctly
  • Claim a throwaway name with --new --yes and confirm the README shows on npmjs.com

…eholder

- README leads with a 'Just claim a name' section right under the demo:
  `npx fledgling add <name> --new --yes` from any directory, plus the
  --skip-trust variant for in-repo claims. Intro now lists claiming and
  trusted-publishing sync as two separately usable jobs.
- The placeholder published to claim a name now includes a README.md
  saying the name was claimed with fledgling (linked), linking the
  package's own repo/homepage when the manifest has one, and pointing
  readers at the same one-liner.
@github-actions

Copy link
Copy Markdown

bumpy-frog

The changes in this PR will be included in the next version bump.

patch Patch releases

  • fledgling 1.2.1 → 1.2.2

Bump files in this PR

Click here if you want to add another bump file to this PR


This comment is maintained by bumpy.

@theoephraim
theoephraim merged commit 93768df into main Sep 17, 2026
1 check passed
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