Skip to content

Conversation

@miparnisari
Copy link
Contributor

@miparnisari miparnisari commented Oct 31, 2025

I didn't understand why we had a FAQ section talking about zanzibar when we have a literal page dedicated to the topic.

@vercel
Copy link

vercel bot commented Oct 31, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
docs Ready Ready Preview Comment Oct 31, 2025 11:57pm

@miparnisari miparnisari changed the title chore: organize zanzibar faqs chore: move zanzibar faqs to zanzibar page Nov 1, 2025
Comment on lines -224 to -230
### What is Google Zanzibar?

Google Zanzibar is a revolutionary authorization system developed by Google to handle the massive scale and complexity of their services.
It's designed to provide consistent, secure, and reliable authorization decisions across Google's vast network of applications and users.
Google published a paper (check out our [annotated copy](https://zanzibar.tech/)) describing the concepts behind its design and implementation.

You may recognize the system if you’ve ever shared access with another user to a Google product like Google Docs or Gmail.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

this FAQ here made no sense to me 😆

Copy link
Contributor

Choose a reason for hiding this comment

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

Check with Sam on this one - I know we've put things into both readmes and docs that are essentially just SEO fodder. I'm not a huge fan of including the content if it's not useful to users, though, so I'd support removing it.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

but this page zanzibar.mdx is about zanzibar. why would we have a section called "what is zanzibar?" at the bottom? it makes us look like we don't know how to write docs

Copy link
Member

Choose a reason for hiding this comment

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

This was previously the hub for our Zanzibar commentary but we have a better page for that now


```sh
docker run --rm -p 50051:50051 -p 8443:8443 authzed/spicedb serve --http-enabled --grpc-preshared-key <preshared key>
docker run --rm -p 50051:50051 -p 8443:8443 authzed/spicedb serve --http-enabled --grpc-preshared-key foobar
Copy link
Contributor Author

Choose a reason for hiding this comment

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

all code snippets should work if you copy-paste them

Copy link
Contributor

@tstirrat15 tstirrat15 left a comment

Choose a reason for hiding this comment

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

See comment

Comment on lines -224 to -230
### What is Google Zanzibar?

Google Zanzibar is a revolutionary authorization system developed by Google to handle the massive scale and complexity of their services.
It's designed to provide consistent, secure, and reliable authorization decisions across Google's vast network of applications and users.
Google published a paper (check out our [annotated copy](https://zanzibar.tech/)) describing the concepts behind its design and implementation.

You may recognize the system if you’ve ever shared access with another user to a Google product like Google Docs or Gmail.
Copy link
Contributor

Choose a reason for hiding this comment

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

Check with Sam on this one - I know we've put things into both readmes and docs that are essentially just SEO fodder. I'm not a huge fan of including the content if it's not useful to users, though, so I'd support removing it.

Comment on lines -224 to -230
### What is Google Zanzibar?

Google Zanzibar is a revolutionary authorization system developed by Google to handle the massive scale and complexity of their services.
It's designed to provide consistent, secure, and reliable authorization decisions across Google's vast network of applications and users.
Google published a paper (check out our [annotated copy](https://zanzibar.tech/)) describing the concepts behind its design and implementation.

You may recognize the system if you’ve ever shared access with another user to a Google product like Google Docs or Gmail.
Copy link
Member

Choose a reason for hiding this comment

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

This was previously the hub for our Zanzibar commentary but we have a better page for that now

@miparnisari miparnisari merged commit b23de9c into main Nov 10, 2025
9 of 10 checks passed
@miparnisari miparnisari deleted the organize-zanzibar branch November 10, 2025 18:00
@github-actions github-actions bot locked and limited conversation to collaborators Nov 10, 2025
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants