diff --git a/docs/learn/spec.md b/docs/learn/spec.md
index 100fe99..c2a1681 100644
--- a/docs/learn/spec.md
+++ b/docs/learn/spec.md
@@ -57,4 +57,4 @@ The spec leaves some things to the application layer:
 
 ✅ **Full compliance** with draft-ietf-httpapi-idempotency-key-header-07
 
-All MUST and SHOULD requirements are implemented. The library gives you the flexibility to choose which optional features to enable based on your API's needs.
+All MUST and SHOULD requirements are implemented.
diff --git a/docs/specs/index.md b/docs/specs/index.md
index e17182a..4db6d0a 100644
--- a/docs/specs/index.md
+++ b/docs/specs/index.md
@@ -1,13 +1,13 @@
 ---
 prev:
   text: "Why Idempotency"
-  link: "/why-idempotency"
+  link: "/learn/why"
 next: false
 ---
 
 # Cucumber Specifications
 
-RFC 7807-compliant specifications for idempotency middleware implementations.
+These Cucumber specifications codify idempot.dev's interpretation of [draft-ietf-httpapi-idempotency-key-header-07](https://datatracker.ietf.org/doc/html/draft-ietf-httpapi-idempotency-key-header-07). The IETF draft defines the requirements; these specs translate them into implementation choices shared by all idempot.dev projects.
 
 ## Overview