diff --git a/README.md b/README.md
index 5b1a4bf8bf..4f2076b604 100644
--- a/README.md
+++ b/README.md
@@ -1,54 +1,62 @@
-# SpiceDB
-
-[](https://bestpractices.coreinfrastructure.org/projects/6348)
-[](https://hub.docker.com/r/authzed/spicedb/tags)
-[](https://docs.authzed.com)
-[](https://authzed.com/discord)
-[](https://twitter.com/authzed)
-
-SpiceDB is an open source, [Google Zanzibar]-inspired database for creating and managing security-critical application permissions.
-
-Developers create a [schema] and use [client libraries] to apply the schema to the database, insert [relationships] into the database, and query the database to efficiently check permissions in their applications.
-
-[Google Zanzibar]: https://authzed.com/blog/what-is-zanzibar/
-[schema]: https://authzed.com/docs/guides/schema
-[client libraries]: https://github.com/authzed/awesome-spicedb#clients
-[relationships]: https://authzed.com/docs/reference/glossary#relationship
-
-Features that distinguish SpiceDB from other systems include:
-
-- Expressive [gRPC] and [HTTP/JSON] APIs for checking permissions, listing access, and powering devtools
-- A distributed, parallel graph-engine faithful to the architecture described in [Google's Zanzibar paper]
-- A flexible consistency model configurable [per-request] that includes resistance to the [New Enemy Problem]
-- An expressive [schema language] with a [playground] and CI/CD integrations for [validation] and [integration testing]
-- A pluggable [storage system] supporting [in-memory], [Spanner], [CockroachDB], [PostgreSQL] and [MySQL]
-- Deep observability with [Prometheus] metrics, [pprof] profiles, structured logging, and [OpenTelemetry] tracing
-
-Want to learn more about the inspiration for SpiceDB? We've annotated [Google's Zanzibar Paper] with our own commentary.
-
-[gRPC]: https://buf.build/authzed/api/docs/main:authzed.api.v1
-[HTTP/JSON]: https://app.swaggerhub.com/apis-docs/authzed/authzed/1.0
-
-[per-request]: https://docs.authzed.com/reference/api-consistency
-[New Enemy Problem]: https://authzed.com/blog/new-enemies/
-
-[schema language]: https://docs.authzed.com/guides/schema
-[playground]: https://play.authzed.com
-[validation]: https://github.com/authzed/action-spicedb-validate
-[integration testing]: https://github.com/authzed/action-spicedb
-
-[storage system]: https://authzed.com/docs/spicedb/selecting-a-datastore
-[in-memory]: https://github.com/hashicorp/go-memdb
-[PostgreSQL]: https://www.postgresql.org
-[Spanner]: https://cloud.google.com/spanner
-[CockroachDB]: https://github.com/cockroachdb/cockroach
-[MySQL]: https://www.mysql.com
-
-[Prometheus]: https://prometheus.io
-[pprof]: https://jvns.ca/blog/2017/09/24/profiling-go-with-pprof/
-[OpenTelemetry]: https://opentelemetry.io
-
-[Google's Zanzibar paper]: https://authzed.com/zanzibar
+
+
+
+ SpiceDB sets the standard for authorization that scales.
+
Scale with
+ Traffic • Dev Velocity • Functionality • Geography
+
+
+
+ 
+
+ 
+
+ 
+
+ 
+
+
+
+
+ 
+
+ 
+
+ 
+
+
+## What is SpiceDB?
+
+SpiceDB is a graph database purpose-built for storing and evaluating access control data.
+
+As of 2021, [broken access control became the #1 threat to the web][owasp]. With SpiceDB, developers finally have the solution to stopping this threat the same way as the hyperscalers.
+
+[owasp]: https://owasp.org/Top10/A01_2021-Broken_Access_Control/
+
+### Why SpiceDB?
+
+- [**World-class engineering**][about]: painstakingly built by experts that pioneered the cloud-native ecosystem
+- [**Authentic design**][zanzibar]: mature and feature-complete implementation of Google's Zanzibar paper
+- [**Proven in production**][1M]: 5ms p95 when scaled to millions of queries/s, billions of relationships
+- [**Global consistency**][consistency]: consistency configured per-request unlocks correctness while maintaining performance
+- [**Multi-paradigm**][caveats]: caveated relationships combine the best concepts in authorization: ABAC & ReBAC
+- [**Safety in tooling**][tooling]: designs schemas with real-time validation or validate in your CI/CD workflow
+- [**Reverse Indexes**][reverse-indexes]: queries for "What can `subject` do?", "Who can access `resource`?"
+
+[about]: https://authzed.com/why-authzed
+[zanzibar]: https://authzed.com/zanzibar
+[1M]: https://authzed.com/blog/google-scale-authorization
+[caveats]: https://netflixtechblog.com/abac-on-spicedb-enabling-netflixs-complex-identity-types-c118f374fa89
+[tooling]: https://authzed.com/docs/spicedb/modeling/validation-testing-debugging
+[reverse-indexes]: https://authzed.com/docs/spicedb/getting-started/faq#what-is-a-reverse-index
+[consistency]: https://authzed.com/docs/spicedb/concepts/consistency
## Joining the Community
@@ -178,9 +186,9 @@ You can try both SpiceDB and zed entirely in your browser on the [playground] th
If you don't want to start with the examples loadable from the Playground, you can follow a guide for [developing a schema] or review the the schema language [design documentation].
-To get a quick idea of schema development, you can watch the creators of SpiceDB writing a schema for GitHub:
+Watch the SpiceDB primer video to get started with schema development:
-[](https://www.youtube.com/watch?v=x3-B9-ICj0w)
+
[developing a schema]: https://docs.authzed.com/guides/schema
[design documentation]: https://docs.authzed.com/reference/schema-lang
@@ -196,7 +204,8 @@ Because every millisecond counts, we recommend using libraries that leverage the
To get an understanding of integrating an application with SpiceDB, you can follow the [Protecting Your First App] guide or review API documentation on the [Buf Registry] or [Postman].
-[installing zed]: https://github.com/authzed/zed
+[installing zed]: https://authzed.com/docs/spicedb/getting-started/installing-zed
+[playground]: https://play.authzed.com
[existing client libraries]: https://github.com/authzed/awesome-spicedb#clients
[Protecting Your First App]: https://docs.authzed.com/guides/first-app
[Buf Registry]: https://buf.build/authzed/api/docs
@@ -209,5 +218,6 @@ We appreciate all contributions, large and small, and would like to thank all th
In addition, we'd like to highlight a few notable contributions:
-- The GitHub Authorization Team for implementing and contributing the MySQL datastore
-- The Netflix Authorization Team for [sponsoring and being a design partner for Caveats](https://authzed.com/blog/abac-on-spicedb-enabling-netflix-complex-identity-types)
+- 
The GitHub Authorization Team for implementing and contributing the MySQL datastore
+- 
The Netflix Authorization Team for sponsoring and being a design partner for caveats
+- 
The Equinix Metal Team for sponsoring our benchmarking hardware
diff --git a/magefiles/lint.go b/magefiles/lint.go
index 741ec51cb4..037d9e2c35 100644
--- a/magefiles/lint.go
+++ b/magefiles/lint.go
@@ -51,7 +51,7 @@ func (Lint) Markdown() error {
}
return sh.RunV("docker", "run", "--rm",
"-v", fmt.Sprintf("%s:/src:ro", cwd),
- "ghcr.io/igorshubovych/markdownlint-cli:v0.34.0", "--config", "/src/.markdownlint.yaml", "/src")
+ "ghcr.io/igorshubovych/markdownlint-cli:v0.39.0", "--config", "/src/.markdownlint.yaml", "/src")
}
// Go Run all go linters