Merge branch 'release/v0.7.3' into main

.github/contributing/writing-guide.md

@@ -161,7 +161,7 @@ We appreciate small, focused PRs. If you'd like to make an extremely large chang
 
 - [Grammarly](https://www.grammarly.com/): Desktop app and browser extension for checking spelling and grammar (though grammar checking doesn't catch everything and occasionally shows a false positive).
 - Spell checking with cspell using the extension [Code Spell Checker extension](https://marketplace.visualstudio.com/items?itemName=streetsidesoftware.code-spell-checker) and the command `npx cspell "**/*.{md,ts,js}"`
-- [Markdown Lint](https://marketplace.visualstudio.com/items?itemName=streetsidesoftware.code-spell-checker): An extension for VS Code to help you check spelling within markdown and code examples.
+- [Markdown Lint](https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint): An extension for VS Code to help you check spelling within markdown and code examples.
 - Table of Contents are generated by the [VSCode Markdown](https://github.com/yzhang-gh/vscode-markdown#table-of-contents) extension using the `markdown.extension.toc.slugifyMode`:`gitea`
 - [Diataxis](https://diataxis.fr/)
 

deploy-versions.json

@@ -1 +1 @@
-[{"text":"Latest","icon":"fas fa-home","key":"latest","tag":"v0.7.2"}]
+[{"text":"Latest","icon":"fas fa-home","key":"latest","tag":"v0.7.3"}]

package.json

@@ -1,6 +1,6 @@
 {
   "name": "zilla-docs",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "The official documentation for the aklivity/zilla open-source project",
   "keywords": [],
   "author": "aklivity.io",

src/reference/config/guards/guard-jwt.md

@@ -11,25 +11,39 @@ tag:
 
 Zilla runtime jwt guard.
 
+If using an Identity Provider that exposes a `.well-known/jwks.json` file, simply provide the `issuer` and `audience`. The JWKS will be fetched, remotely.
+
+```yaml {2}
+guards:
+  jwt:
+    type: jwt
+    options:
+      issuer: https://auth.example.com
+      audience: https://api.example.com
+```
+
+Manual configuration is also supported.
+
 ```yaml {2}
-jwt:
-  type: jwt
-  options:
-    issuer: https://auth.example.com
-    audience: https://api.example.com
-    keys:
-      - kty: EC
-        crv: P-256
-        x: MKBCTNIcKUSDii11ySs3526iDZ8AiTo7Tu6KPAqv7D4
-        y: 4Etl6SRW2YiLUrN5vfvVHuhp7x8PxltmWWlbbM4IFyM
-        use: enc
-        kid: '1'
-      - kty: RSA
-        n: 0vx7agoebGcQSuuPiLJXZptN9nndrQmbXEps2aiAFbWhM78LhWx4cbbfAAtVT86zwu1RK7aPFFxuhDR1L6tSoc_BJECPebWKRXjBZCiFV4n3oknjhMstn64tZ_2W-5JsGY4Hc5n9yBXArwl93lqt7_RN5w6Cf0h4QyQ5v-65YGjQR0_FDW2QvzqY368QQMicAtaSqzs8KJZgnYb9c7d0zgdAZHzu6qMQvRL5hajrn1n91CbOpbISD08qNLyrdkt-bFTWhAI4vMQFh6WeZu0fM4lFd2NcRwr3XPksINHaQ-G_xBniIqbw0Ls1jF44-csFCur-kEgU8awapJzKnqDKgw
-        e: AQAB
-        alg: RS256
-        kid: '2011-04-29'
-    challenge: 30
+guards:
+  jwt:
+    type: jwt
+    options:
+      issuer: https://auth.example.com
+      audience: https://api.example.com
+      keys:
+        - kty: EC
+          crv: P-256
+          x: MKBCTNIcKUSDii11ySs3526iDZ8AiTo7Tu6KPAqv7D4
+          y: 4Etl6SRW2YiLUrN5vfvVHuhp7x8PxltmWWlbbM4IFyM
+          use: enc
+          kid: '1'
+        - kty: RSA
+          n: 0vx7agoebGcQSuuPiLJXZptN9nndrQmbXEps2aiAFbWhM78LhWx4cbbfAAtVT86zwu1RK7aPFFxuhDR1L6tSoc_BJECPebWKRXjBZCiFV4n3oknjhMstn64tZ_2W-5JsGY4Hc5n9yBXArwl93lqt7_RN5w6Cf0h4QyQ5v-65YGjQR0_FDW2QvzqY368QQMicAtaSqzs8KJZgnYb9c7d0zgdAZHzu6qMQvRL5hajrn1n91CbOpbISD08qNLyrdkt-bFTWhAI4vMQFh6WeZu0fM4lFd2NcRwr3XPksINHaQ-G_xBniIqbw0Ls1jF44-csFCur-kEgU8awapJzKnqDKgw
+          e: AQAB
+          alg: RS256
+          kid: '2011-04-29'
+      challenge: 30
 ```
 
 ## Summary
@@ -48,9 +62,9 @@ Each verified JWT access token has an expiration time, and an optional challenge
 - [options.issuer](#options-issuer)
 - [options.audience](#options-audience)
 - [options.challenge](#options-challenge)
-- [options.keys\*](#options-keys)
-- [keys\[\].kty\*](#keys-kty)
-- [keys\[\].kid\*](#keys-kid)
+- [options.keys](#options-keys)
+- [keys\[\].kty](#keys-kty)
+- [keys\[\].kid](#keys-kid)
 - [keys\[\].n](#keys-n)
 - [keys\[\].e](#keys-e)
 - [keys\[\].alg](#keys-alg)
@@ -107,17 +121,19 @@ Audience claim.
 
 Challenge period (seconds).
 
-### options.keys\*
+### options.keys
 
 > `array` of `object`
 
-### keys[].kty\*
+If not provided, relies on the `issuer` to infer the location of a remote `.well-known/jwks.json` file.
+
+### keys[].kty
 
 > `string`
 
 Key type, e.g. `RSA` , `EC`.
 
-### keys[].kid\*
+### keys[].kid
 
 > `string`