Skip to content

GEO draft: answer-first block, facts table, TypeScript examples and FAQ for Node.js SDK quickstart - #667

Merged
orweis merged 2 commits into
masterfrom
geo/answer-ready-nodejs-sdk
Oct 6, 2026
Merged

orweis merged 2 commits into
masterfrom
geo/answer-ready-nodejs-sdk

Conversation

@orweis

@orweis orweis commented Oct 4, 2026

Copy link
Copy Markdown
Contributor

Draft for Or / R&D review. Do not merge until reviewed. Part of the GEO/AEO docs answer-ready pass (plan: Action 1, geo-aeo-plan-2026-10-05). Opened by Content Bot on behalf of Or Weis.

Pages

  • docs/sdk/nodejs/quickstart-nodejs.mdx: answer block (53 words), facts table, new TypeScript section "Check a tenant, a resource instance, and several permissions at once" (permit.check() with tenant and type:key forms, permit.bulkCheck()), FAQ.

Where the facts come from

  • npm registry (verified 2026-10-05): permitio latest 2.7.6, published 2026-06-24, MIT, ships TypeScript types, CommonJS and ES module builds.
  • Repo docs for PDP URLs, throwOnError (default true in the 2.7.6 source), feature parity, and the Edge-runtime limit.
  • The TypeScript snippet compiles with tsc --strict against the 2.7.6 types.

Pricing facts and re-check

Free-tier values are copied from the live https://www.permit.io/pricing page (Community column of Compare Plans, labeled "Free Forever"), fetched 2026-10-05:
MAU 1000, Tenants 20, Authorization Queries No Limit, Environments 3, PDP Instances No Limit (also in the pages that say so: Roles 25, Resource Types 50, Logs Retention 14 days).

  • TODO (reviewer): re-open the pricing page before merging and confirm these values still match. Each page has an MDX comment {/* GEO pass: ... */} next to the table naming the source and fetch date.

R&D, please double check

  • Request shapes were checked with a mock PDP, not a live environment.
  • The facts table pins 2.7.6 as "verified against". Bump it on release or drop the pin if you prefer.

Style and checks

  • No em or en dashes, no curly quotes, no filler words in added text. Answer-first blocks are 40 to 70 words (counted).
  • Existing technical content and existing code samples are unchanged. New content is added under the answer block, in new sections, or before the Next steps section.
  • npm run build (redirect-lint, relative links, private paths, Docusaurus build, hyperlink anchors, routes check, sidebar coverage) passed on a temporary branch with all six GEO branches merged.
  • Fit statements ("use X when / don't use X when") are editorial. Please confirm they are acceptable.

@netlify

netlify Bot commented Oct 4, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for permitio-docs ready!

Name Link
🔨 Latest commit 94caf60
🔍 Latest deploy log https://app.netlify.com/projects/permitio-docs/deploys/6ac4a149fb2242000935a131
😎 Deploy Preview https://deploy-preview-667--permitio-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@orweis
orweis marked this pull request as ready for review October 6, 2026 07:17
@orweis
orweis merged commit bd2414c into master Oct 6, 2026
4 checks passed
@orweis
orweis deleted the geo/answer-ready-nodejs-sdk branch October 6, 2026 07:22
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