Skip to content

Ship the root README to npm instead of a hand-kept copy - #198

Merged
devmaxxx merged 1 commit into
mainfrom
fix/npm-readme-from-root
Oct 17, 2026
Merged

devmaxxx merged 1 commit into
mainfrom
fix/npm-readme-from-root

Conversation

@devmaxxx

Copy link
Copy Markdown
Owner

Summary

The npm page showed npm/zerograph/README.md, a short copy last changed in #187, so the badges, navigation and comparison image from #188 never reached npm.

scripts/npm-pack.sh now cuts the package README from the root README.md at pack time and pins each relative path to the version tag: images go to raw.githubusercontent.com, links to github.com/.../blob/vX.Y.Z/. The hand-kept copy is untracked and gitignored.

npm only refreshes a README on publish, so the page changes with the next release.

Test plan

  • scripts/npm-pack.sh 9.9.9: the packed README is the root one, with no relative ](...) left and the comparison image on a raw URL
  • node --test npm/zerograph/test/launcher.test.js: 9 pass
  • CI pack jobs green

The npm page showed npm/zerograph/README.md, a short copy last touched in
#187, so the badges, navigation and comparison image from #188 never reached
it. scripts/npm-pack.sh now cuts the package README from the root one and
pins every relative path to the version's tag, since npm resolves none.
@devmaxxx
devmaxxx merged commit fb0f109 into main Oct 17, 2026
4 checks passed
@devmaxxx
devmaxxx deleted the fix/npm-readme-from-root branch October 17, 2026 15:47
devmaxxx added a commit that referenced this pull request Oct 17, 2026
* chore(release): bump to 0.6.2

Ships the root README to npm (#198); the binary is unchanged.

* docs(readme): drop the from-source install line

The README is now the npm page too, where a source checkout is not what
the reader has; docs/install.md keeps the source route.

* docs(readme): add a step-by-step project setup

The README is the npm page now, so the first thing a reader there needs is
how to wire zerograph into their own repository: ignore the store, build,
ask, connect the agent, and where the config lives.

* docs(readme): fold the project setup into one command block
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