docs: document v6.0.0 release

Author: subzeroid

CHANGELOG.md

@@ -0,0 +1,37 @@
+# Changelog
+
+## v6.0.0 - 2026-05-21
+
+Release: <https://github.com/subzeroid/aiograpi-rest/releases/tag/v6.0.0>
+
+### Changed
+
+- Upgraded the wrapped client to `aiograpi==1.0.9`.
+- Updated the package version to `6.0.0`.
+- Reworked account password and email flows for current aiograpi semantics:
+  `POST /account/password/reset`, `POST /account/email/confirmation`, and
+  `POST /account/email/confirm`.
+- Updated Reel upload with music to use aiograpi's current
+  `clip_upload_with_music` method and expose the new optional upload fields.
+
+### Added
+
+- Direct routes for request previews, channels, interop upgrade status, GenAI
+  bot suggestions, and E2EE eligibility.
+- Music routes for current catalog search, keyword search, trending music, top
+  trends, Reels music browsing, audio bookmarking, and original-audio title
+  availability.
+- Media note routes: `POST /media/note` and `DELETE /media/note`.
+
+### Removed
+
+- Removed the public `GET /hashtag/related` route because aiograpi 1.0.x no
+  longer exposes `hashtag_related_hashtags`.
+
+### Verified
+
+- Offline test gate: `270 passed, 6 deselected`, `100.00%` coverage.
+- Live smoke gate: `/user/about`, paginated reads, story upload/read/download
+  cleanup, and media upload/edit/delete state checks passed on Python 3.13.
+- Release workflow verified PyPI, Docker Hub, GHCR, GitHub Release artifacts,
+  and a smoke test of the published Docker image.

README.md

@@ -46,6 +46,10 @@ such as `/media/unlike`, `/user/unfollow`, and `/media/unarchive` were removed
 before the public API became widely used; use `DELETE /media/like`,
 `DELETE /user/follow`, and `DELETE /media/archive`.
 
+Current stable release: [`v6.0.0`](CHANGELOG.md), wrapping `aiograpi==1.0.9`.
+Use `subzeroid/aiograpi-rest:6.0.0` when you want a pinned Docker runtime, or
+`subzeroid/aiograpi-rest:latest` when you intentionally want the newest release.
+
 ```bash
 docker run --rm -p 8000:8000 subzeroid/aiograpi-rest
 ```
@@ -258,6 +262,7 @@ Docker Hub and GitHub Packages. An `X.Y.Z` tag publishes
 
 PyPI and GitHub Release artifacts are published from the same tag workflow,
 including the built wheel, source distribution, and `openapi.json`.
+See the [changelog](CHANGELOG.md) for release notes and verification evidence.
 
 GitHub Packages image:
 

docs/api.md

@@ -1,5 +1,8 @@
 # API Guide
 
+This guide is current for `aiograpi-rest v6.0.0`, which wraps
+`aiograpi==1.0.9`.
+
 ## Authentication
 
 Protected routes accept the saved session ID through the `X-Session-ID` header.

docs/changelog.md

@@ -0,0 +1,37 @@
+# Changelog
+
+## v6.0.0 - 2026-05-21
+
+Release: <https://github.com/subzeroid/aiograpi-rest/releases/tag/v6.0.0>
+
+### Changed
+
+- Upgraded the wrapped client to `aiograpi==1.0.9`.
+- Updated the package version to `6.0.0`.
+- Reworked account password and email flows for current aiograpi semantics:
+  `POST /account/password/reset`, `POST /account/email/confirmation`, and
+  `POST /account/email/confirm`.
+- Updated Reel upload with music to use aiograpi's current
+  `clip_upload_with_music` method and expose the new optional upload fields.
+
+### Added
+
+- Direct routes for request previews, channels, interop upgrade status, GenAI
+  bot suggestions, and E2EE eligibility.
+- Music routes for current catalog search, keyword search, trending music, top
+  trends, Reels music browsing, audio bookmarking, and original-audio title
+  availability.
+- Media note routes: `POST /media/note` and `DELETE /media/note`.
+
+### Removed
+
+- Removed the public `GET /hashtag/related` route because aiograpi 1.0.x no
+  longer exposes `hashtag_related_hashtags`.
+
+### Verified
+
+- Offline test gate: `270 passed, 6 deselected`, `100.00%` coverage.
+- Live smoke gate: `/user/about`, paginated reads, story upload/read/download
+  cleanup, and media upload/edit/delete state checks passed on Python 3.13.
+- Release workflow verified PyPI, Docker Hub, GHCR, GitHub Release artifacts,
+  and a smoke test of the published Docker image.

docs/getting-started.md

@@ -6,6 +6,12 @@
 docker run --rm -p 8000:8000 subzeroid/aiograpi-rest
 ```
 
+For a pinned runtime, use the current stable tag:
+
+```bash
+docker run --rm -p 8000:8000 subzeroid/aiograpi-rest:6.0.0
+```
+
 Open <http://localhost:8000/docs> for Swagger UI.
 
 For local development from a checkout:

docs/index.md

@@ -42,3 +42,6 @@ The service intentionally exposes a focused subset of `aiograpi.Client`. The
 generated [aiograpi coverage report](aiograpi-coverage.md) lists every public
 client method, whether it is reachable through a REST route, and whether an
 uncovered method is a duplicate implementation variant or an internal helper.
+
+Current stable release: `v6.0.0`, wrapping `aiograpi==1.0.9`. See the
+[changelog](changelog.md) for release notes and verification evidence.

mkdocs.yml

@@ -10,6 +10,7 @@ nav:
   - API Guide: api.md
   - Client Generation: client-generation.md
   - aiograpi Coverage: aiograpi-coverage.md
+  - Changelog: changelog.md
 theme:
   name: material
 markdown_extensions: