Skip to content

Add Cloud PDP benchmarks documentation#624

Merged
omer9564 merged 4 commits into
masterfrom
omer/per-14545-upload-cloud-pdp-benchmarks-to-the-docs
Jun 16, 2026
Merged

Add Cloud PDP benchmarks documentation#624
omer9564 merged 4 commits into
masterfrom
omer/per-14545-upload-cloud-pdp-benchmarks-to-the-docs

Conversation

@omer9564

Copy link
Copy Markdown
Contributor

Summary

  • Adds a new Cloud PDP Benchmarks page under Concepts → PDP with RBAC and ReBAC performance data
  • Includes latency percentiles (P50–P99), throughput, and results across concurrency levels (1 and 10) and ReBAC relationship depths (1–3 hops)
  • Adds sidebar entry under "The Policy Decision Point (PDP)" section

Test plan

  • Verify the page renders correctly on the Netlify preview
  • Confirm sidebar link appears under PDP section
  • Review benchmark data accuracy

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@linear

linear Bot commented Apr 21, 2026

Copy link
Copy Markdown

@netlify

netlify Bot commented Apr 21, 2026

Copy link
Copy Markdown

Deploy Preview for permitio-docs ready!

Name Link
🔨 Latest commit be58709
🔍 Latest deploy log https://app.netlify.com/projects/permitio-docs/deploys/6a312b027464d80008c19952
😎 Deploy Preview https://deploy-preview-624--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.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new documentation page describing Cloud PDP performance benchmarks and links it from the PDP section in the docs sidebar.

Changes:

  • Added a new Cloud PDP Benchmarks MDX page with RBAC/ReBAC latency and throughput tables.
  • Linked the new page under The Policy Decision Point (PDP) in the docs sidebar.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File Description
sidebars.js Adds the new Cloud PDP benchmarks doc to the PDP sidebar section.
docs/concepts/pdp/cloud-pdp-benchmarks.mdx Introduces benchmark results and key takeaways for Cloud PDP performance.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/concepts/pdp/cloud-pdp-benchmarks.mdx Outdated
Comment thread docs/concepts/pdp/cloud-pdp-benchmarks.mdx
Comment thread docs/concepts/pdp/cloud-pdp-benchmarks.mdx Outdated

@zeevmoney zeevmoney left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is an automated review. See comments.

Comment thread docs/concepts/pdp/cloud-pdp-benchmarks.mdx Outdated
Comment thread docs/concepts/pdp/cloud-pdp-benchmarks.mdx Outdated
Comment thread docs/concepts/pdp/cloud-pdp-benchmarks.mdx Outdated

@zeevmoney zeevmoney left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved ✅ — with comments to address before merge

Thanks @omer9564 — the page is a solid addition and the data tables are internally consistent. Approving so this isn't blocked, but please look over the review comments first.

Please see the inline comments, address them, and then merge. A few are worth a quick pass:

  • [MEDIUM] Add a short methodology note (line 10) — date, regions, endpoint, payload, policy size, and the load model. The throughput figures reflect the load generator's offered rate (~paced), not the PDP's capacity, so it's worth saying so explicitly.
  • [MEDIUM] The Depth 2/3 scenarios (lines 76–94) reference Drive and Comment resources that don't appear in the cloud-pdp ReBAC fixtures, and I couldn't trace these numbers to any benchmark script in that repo — please confirm the schema/source and ideally link the tooling.
  • [MEDIUM] Soften "Throughput scales linearly" (line 111) and [LOW] fix the mean-vs-P50 wording (line 110).
  • [LOW] Depth 2/3 are missing the single-concurrency tables that RBAC and Depth 1 have (line 76).

None of these block the doc from going live — they're accuracy/clarity improvements. Fix them up and merge when you're happy. 🚀

Comment thread docs/concepts/pdp/cloud-pdp-benchmarks.mdx
Comment thread docs/concepts/pdp/cloud-pdp-benchmarks.mdx
- Add a Methodology section (date, region, server-side metric source, load notes)
- Correct latency description: server-side processing time, not network round-trip
- Reword P50 takeaway to a single statistic (mean vs P50 conflation)
- Soften "throughput scales linearly" to "near-linearly"
- Note why Depth 2/3 show only the 10-concurrent case

Addresses review comments:
- #624 (comment) (@copilot-pull-request-reviewer)
- #624 (comment) (@copilot-pull-request-reviewer)
- #624 (comment) (@copilot-pull-request-reviewer)
- #624 (comment) (@zeevmoney)
- #624 (comment) (@zeevmoney)
- #624 (comment) (@zeevmoney)
- #624 (comment) (@zeevmoney)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@omer9564 omer9564 merged commit 16539a1 into master Jun 16, 2026
4 checks passed
@omer9564 omer9564 deleted the omer/per-14545-upload-cloud-pdp-benchmarks-to-the-docs branch June 16, 2026 11:26
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.

3 participants