📝 Improved documentation

Author: pboling

CHANGELOG.md

@@ -20,6 +20,8 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Added
 
+- [gh!683][gh!683] Improve documentation by @pboling
+
 ### Changed
 
 ### Deprecated
@@ -30,6 +32,8 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+[gh!683]: https://github.com/ruby-oauth/oauth2/pull/683
+
 ## [2.0.17] - 2025-09-15
 
 - TAG: [v2.0.17][2.0.17t]
@@ -41,6 +45,8 @@ Please file a bug if you notice a violation of semantic versioning.
 
 - [gh!682][gh!682] - AccessToken: support Hash-based verb-dependent token transmission mode (e.g., {get: :query, post: :header})
 
+[gh!682]: https://github.com/ruby-oauth/oauth2/pull/682
+
 ## [2.0.16] - 2025-09-14
 
 - TAG: [v2.0.16][2.0.16t]

README.md

@@ -62,9 +62,10 @@ NOTE: `header` - The content type specified in the `curl` is already the default
 </details>
 
 <details>
-<summary>Complete E2E single file script against [navikt/mock-oauth2-server](https://github.com/navikt/mock-oauth2-server)</summary>
+<summary>Complete E2E single file script against mock-oauth2-server</summary>
 
-- E2E example using the mock test server added in v2.0.11
+- E2E example uses [navikt/mock-oauth2-server](https://github.com/navikt/mock-oauth2-server), which was added in v2.0.11
+- E2E example does not ship with the released gem, so clone the source to play with it.
 
 ```console
 docker compose -f docker-compose-ssl.yml up -d --wait