Repository navigation
docs: stop positioning Askr as new and unused - #63
Merged
Merged
Conversation
Only @askrjs/askr had a newer release; the other 16 @askrjs packages were already at their latest published version. The declared ranges (>=0.3.0 <0.4.0) already covered it, so package.json is unchanged. Regenerated the package snapshot with `npm run docs:snapshot`. The diff is version strings only -- no entrypoint, signature, or peer-dependency changes -- so the release is API-identical.
Askr serves production applications today -- static marketing sites and admin consoles, this site included -- but the copy read as pre-adoption. The framing was concentrated in /contribute, which called Askr "an early open-source project maintained by one person" that was "young enough that some paths will be unfinished," under an "Early contribution opportunities" heading, an "Early contributors" footer link, and a "Become an early contributor" page title. One opportunity card asked contributors to "build real applications, find rough edges," implying none existed. Meanwhile /production detailed deployment mechanics without ever saying anything was deployed. - /contribute: lead with production use; drop the maintainer headcount while keeping the "you work directly with the people maintaining it" substance; replace the "young/unfinished" paragraph with a pointer to the docs' experimental/limited badges as the map of where the surface is thin - /production: new "What already runs on this" section naming this site as the inspectable instance - /: hero production line and a closing-CTA clause - Route metadata and footer link: drop "early" - llms.txt: state production use in the canonical summary agents read Claims stay first-party and unattributed -- nothing implies third-party adoption. Marketing carries no version or stability hedging; the docs' per-page status badges remain the single place status is asserted, and the accurate per-feature caveats there are untouched. todo.md items 2 and 3 were stale (cited 0.0.x versions, "no production story") and item 3 recommended adding the hedging this commit removes.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
Askr serves production applications today — static marketing sites and admin consoles, this site included — but the copy read as pre-adoption. The site never overclaimed (no fake logos, no invented adoption); it undersold.
The framing was concentrated in
/contribute, which described Askr as "an early open-source project maintained by one person" that was "young enough that some paths will be unfinished," under an "Early contribution opportunities" heading, an "Early contributors" footer link, and a<title>of "Become an early contributor." One opportunity card asked contributors to "build real applications, find rough edges" — implying none existed. Meanwhile/productionexplained deployment mechanics in detail and never mentioned that anything was actually deployed.What changed
marketing/contribute.tsxexperimental/limitedbadges as the map of where the surface is thinmarketing/production.tsxmarketing/home.tsxmarketing/_routes.tsx/contributetitle → "Contribute to Askr"; "early" dropped from the meta descriptionsite-footer.tsxstyles.css.hero__proofrule + mobile spacingpublic/llms.txttodo.mdAlso included as a separate commit:
@askrjs/askr0.3.1 (the only@askrjspackage with a newer release — the other 16 were already current).package.jsonis unchanged since the declared ranges already covered it; the regenerated snapshot diff is version strings only, so the release is API-identical.Deliberate boundaries
experimental/limitedbadges remain the single place status is asserted, and/contributenow points readers at them. The accurate per-feature caveats there (e.g. selective hydration) are untouched — dropping marketing hedging doesn't make those dishonest, it makes them authoritative.askr ssg, not that it came fromaskr create. It now says only what the build actually does.Verification
npm run checkplus the browser suite, all passing:fmt:check,lint,typecheckNew copy confirmed present in the rendered
dist/HTML. A final grep shows noearly/youngframing left in any published surface.