commentail 0.1.0__tar.gz → 0.2.0__tar.gz

commentail-0.2.0/CHANGELOG.md

@@ -0,0 +1,116 @@
+# Changelog
+
+Each release records changes relative to the previous version. Upgrade notes
+describe changes that an existing installation needs to review.
+
+## [0.2.0] — 2026-10-19 · Beta
+
+Changes from **0.1.1 → 0.2.0**.
+
+### Added
+
+- `commentail_recent` template tag for latest published comments with a limit,
+  exact Page filter, optional replies and host-owned markup. Selection enforces
+  visitor access, Site isolation and hidden-discussion settings; results contain
+  plain presentation fields and comment permalinks without private model data.
+
+- Grouped Comments settings in the Wagtail Page editor, with site inheritance
+  and existing save/publication behavior preserved.
+- Russian README included in the source distribution.
+
+- Minimal HTML emails for all five notification types, with host Site names,
+  explanatory copy, labelled action links and equivalent plain text in all six
+  supported languages. Revision decisions have distinct subjects and explanations.
+
+- German (`de`), French (`fr`), Spanish (`es`) and Brazilian Portuguese (`pt-br`)
+  translations for public forms, validation/action messages, moderation/settings,
+  delivery screens and all five notification email types, including revision decisions.
+- Source-coverage and compiled-catalog checks for every shipped locale, plus
+  regression checks for recipient-language mail delivery and English fallback.
+
+### Fixed
+
+- Bounded and indexed recent-comment reads, batched Page access checks and reused
+  target URLs. Discussion rendering groups reply counts and avoids per-comment
+  target/settings/revision queries; moderation totals use a shared aggregate.
+- Whole-word rule matching avoids a rule-by-text-position scan. Cleanup locks
+  only expired unconfirmed candidates; worker claims preload authors/revisions.
+- The moderation Page filter uses Wagtail's searchable chooser instead of loading
+  every discussion Page into its HTML. Added reproducible synthetic load checks.
+
+- Email copy distinguishes revision approval from public visibility, explains
+  editing cutoff for replies awaiting moderation, and uses contextual action
+  labels without promising new replies in read-only discussions.
+
+- Generated author labels in reply emails use the recipient's saved language,
+  including the generic account name, instead of the mail worker's language.
+
+### Upgrade notes
+
+- Host email overrides keep precedence; review
+  both MIME alternatives and any custom subject/body wording when upgrading.
+- Enable the desired language through the host site's Django language settings;
+  use `pt-br` for Brazilian Portuguese. Commentail's gettext directory is `pt_BR`.
+- Documentation remains in English and Russian.
+- Run migration `0014_reading_indexes` for publication/thread, active CAPTCHA and
+  rate-cleanup indexes, then recollect static files. Index builds may block writes
+  on large tables; SQLite also rebuilds the rate-event table. See
+  [performance and migration guidance](docs/wiki/Performance.md).
+
+## [0.1.1] — 2026-10-19 · Beta
+
+Changes from **0.1.0 → 0.1.1**.
+
+### Added
+
+- Wagtail 8.0 support with Django 5.2, 6.0 or 6.1, and Django 6.0 support on
+  Wagtail 7.4.3+. The five framework pairs cover Python 3.12–3.14 with file
+  SQLite and PostgreSQL 16 (30 combinations).
+- Regression coverage for capability access, extension/presentation contracts,
+  lifecycle transactions, concurrency and mail-worker recovery.
+- A public roadmap, including expansion of supported UI and email languages/locales.
+
+### Changed
+
+- New guest names allow **40 Unicode graphemes**, down from 80, after trimming.
+  Server validation and browser guidance reject overlong input without truncation.
+  Existing stored names and registered-account names are preserved.
+- PostgreSQL installation guidance explicitly includes `django.contrib.postgres`
+  for Django 6.x checks.
+
+### Fixed
+
+- Email action and status links now follow the configured Commentail URL prefix,
+  including nested paths, instead of assuming `/commentail/`.
+- The guest-name label uses its own translation context, preventing collisions
+  with host-site translations for other uses of "Name".
+
+### Upgrade notes
+
+- No new Commentail database migrations; framework upgrades may have their own.
+- Review overridden guest forms for the 40-grapheme limit and recollect static files.
+- Previously delivered emails are not rewritten. Pending mail uses the installed
+  version's URL generation; existing SMTP retry/duplicate-delivery limits remain.
+- UI and email languages remain English and Russian. Additional locales are planned.
+
+See [0.1.1 release notes](docs/releases/0.1.1.md) and
+[installation/restoration](docs/wiki/Installation.md).
+
+## [0.1.0] — 2026-10-17 · Beta
+
+Initial release for Wagtail 7.4.3+ within 7.4, Django 5.2 and Python 3.12–3.14.
+
+- Template-based Page integration and adapters for ordinary Django models.
+- Site/Page configuration, moderation queue, group permissions and CSV rules.
+- Verified guests, replaceable CAPTCHA and Site-scoped rate limits.
+- Threaded replies, inline author revisions and protected guest actions.
+- Database email outbox, direct-reply notifications and unsubscribe.
+- Schema.org Comment microdata and JSON-LD, with per-site output selection.
+- Theme inheritance, template overrides, Python hooks and English/Russian UI.
+
+See [0.1.0 release notes](docs/releases/0.1.0.md).
+
+[0.1.1]: https://github.com/hardcodd/Commentail/compare/v0.1.0...v0.1.1
+[0.1.0]: https://github.com/hardcodd/Commentail/releases/tag/v0.1.0
+
+[0.2.0]: https://github.com/hardcodd/Commentail/compare/v0.1.1...v0.2.0

{commentail-0.1.0 → commentail-0.2.0}/MANIFEST.in

@@ -1,8 +1,8 @@
 recursive-include tests *.py *.html *.js
 recursive-include example *.py *.html *.md
-include requirements-test.txt
+include requirements-test.txt requirements-test-common.txt
 recursive-include tools *.py
-include CHANGELOG.md
+include CHANGELOG.md README.ru.md
 recursive-include docs/wiki *.md
 recursive-include docs/releases *.md
 include docs/assets/commentail-preview.png

{commentail-0.1.0/commentail.egg-info → commentail-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: commentail
-Version: 0.1.0
+Version: 0.2.0
 Summary: Self-hosted Wagtail comments with moderation, verified guests and threaded replies
 License-Expression: MIT
 Project-URL: Source, https://github.com/hardcodd/Commentail
@@ -10,6 +10,8 @@ Project-URL: Changelog, https://github.com/hardcodd/Commentail/blob/main/CHANGEL
 Project-URL: Funding, https://pay.cloudtips.ru/p/f92ee349
 Classifier: Development Status :: 4 - Beta
 Classifier: Framework :: Django :: 5.2
+Classifier: Framework :: Django :: 6.0
+Classifier: Framework :: Django :: 6.1
 Classifier: Framework :: Wagtail
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
@@ -17,8 +19,8 @@ Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: Django<5.3,>=5.2
-Requires-Dist: Wagtail<7.5,>=7.4.3
+Requires-Dist: Django<6.2,>=5.2
+Requires-Dist: Wagtail<8.1,>=7.4.3
 Requires-Dist: regex>=2026.9.29
 Provides-Extra: postgres
 Requires-Dist: psycopg[binary]>=3.3.6; extra == "postgres"
@@ -33,6 +35,9 @@ Dynamic: license-file
 Moderated discussions, verified guests and inline replies — styled by your site.
 
 [![Tests and distributions](https://github.com/hardcodd/Commentail/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/hardcodd/Commentail/actions/workflows/tests.yml)
+[![Django Packages · Commentail](https://img.shields.io/badge/Django%20Packages-Commentail-0C4B33.svg)](https://djangopackages.org/packages/p/commentail/)
+
+English · [Русский](README.ru.md)
 
 [Get started](#quick-start) · [Documentation](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Home.md) · [Wiki](https://github.com/hardcodd/Commentail/wiki) · [Support](#support-commentail)
 
@@ -40,7 +45,7 @@ Moderated discussions, verified guests and inline replies — styled by your sit
 
 </div>
 
-Commentail is a Django comments library built for **Wagtail 7.4 LTS**. Add a
+Commentail is a Django comments library for **Wagtail 7.4 LTS and 8.0**. Add a
 Django template tag to an article, moderate discussions inside Wagtail, and keep
 content, accounts and email delivery in your own application.
 
@@ -48,7 +53,10 @@ The widget inherits your site's typography and colors. CSS custom properties,
 replaceable templates and Python callbacks let you adapt it without a frontend
 framework or an external comments platform.
 
-> Wagtail 8.0 is not supported by 0.1.0.
+> **0.2.0 Beta** adds recent comments, six languages,
+> HTML emails and indexed database reads.
+> [Version-to-version changelog](https://github.com/hardcodd/Commentail/blob/main/CHANGELOG.md) · [Roadmap](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Roadmap.md).
+> [Changes and upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.2.0.md).
 
 ## Why Commentail?
 
@@ -73,17 +81,32 @@ the visible text and author name. Choose either format or disable output in Pyth
 | Component | Version / requirement |
 | --- | --- |
 | Python | 3.12–3.14 |
-| Wagtail | >=7.4.3, <7.5 |
-| Django | >=5.2, <5.3 |
-| Database | SQLite or PostgreSQL; CI covers PostgreSQL 14 |
-| UI languages | English and Russian |
+| Wagtail / Django | 7.4.3+ in 7.4 / Django 5.2 or 6.0; 8.0.x / Django 5.2, 6.0 or 6.1 |
+| Database | File SQLite or PostgreSQL 16 |
+| UI and email languages | English, Russian, German, French, Spanish and Brazilian Portuguese |
 | Frontend | Django templates, optional progressive JavaScript |
 | License | [MIT](https://github.com/hardcodd/Commentail/blob/main/LICENSE) |
 
+This table describes the 0.2.0 Beta release. CI defines all five framework
+pairs on Python 3.12, 3.13 and 3.14 with both databases (30 combinations).
+Package bounds are `Wagtail>=7.4.3,<8.1` and `Django>=5.2,<6.2`; only the pairs
+listed above are supported. Wagtail 7.4 with Django 6.1 is outside this matrix.
+Wagtail 8.1 and later require separate verification before support is declared.
+
 Guest comments require configured SMTP and the scheduled worker. Registered
 users can comment without an email address, but receive no mail. Your site
 provides login and registration. No required external CDN or CAPTCHA service.
 
+### Languages
+
+Alongside English and Russian, 0.2.0 includes German (`de`), French (`fr`),
+Spanish (`es`) and Brazilian Portuguese (`pt-br`) for the public UI,
+moderation/settings and all notification emails.
+The host site selects the active Django language; queued emails retain the
+recipient's saved language. User comments and rejection reasons are not translated.
+Documentation remains in English and Russian.
+[Language configuration →](docs/wiki/Configuration.md#languages)
+
 ## Quick start
 
 ### 1. Install
@@ -91,16 +114,22 @@ provides login and registration. No required external CDN or CAPTCHA service.
 In your site's virtual environment, install the release:
 
 ```sh
-python -m pip install commentail==0.1.0
+python -m pip install commentail==0.2.0
 ```
 
-For the optional PostgreSQL driver, use `python -m pip install 'commentail[postgres]==0.1.0'`.
-You can also install a downloaded wheel directly, or extract the source distribution
-and run `python -m pip install .` in its root.
+For the optional PostgreSQL driver, use
+`python -m pip install 'commentail[postgres]==0.2.0'`.
+You can also extract the source distribution and run `python -m pip install .` in its root.
+When upgrading from 0.1.1, review the
+[upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.2.0.md),
+including migration `0014_reading_indexes` and email overrides. For older
+installations, also review the [0.1.1 notes](docs/releases/0.1.1.md). The 0.1.0 package retains
+its original Wagtail 7.4 and Django 5.2 limits.
 
 ### 2. Connect Django and Wagtail
 
 - Add `commentail` and `wagtail.contrib.settings` to your existing `INSTALLED_APPS`.
+- With PostgreSQL, also include `django.contrib.postgres` (required by Django 6.x checks).
 - Insert `commentail.middleware.CapabilityHeadersMiddleware` before CSRF middleware.
 - Retain the host session/authentication/messages middleware and template request context processor.
 - Include Commentail URLs **before** Wagtail's catch-all:
@@ -127,8 +156,28 @@ The template controls where Page comments are available; the corresponding Page
 editor receives a Comments tab. Configure site defaults, then inherit or override
 on individual Pages. **Review all** is the initial moderation policy.
 
+### Recent comments elsewhere
+
+Use the recent-comments tag on a home page, sidebar or another template:
+
+```django
+{% load commentail_tags %}
+{% commentail_recent limit=5 as recent_comments %}
+{% for comment in recent_comments %}
+  <a href="{{ comment.url }}">{{ comment.author_name }}: {{ comment.text|truncatechars:120 }}</a>
+{% endfor %}
+```
+
+Use `page=page` for one Page and `include_replies=False` for roots only. The list
+respects the current visitor's access and Site, requires a request context and
+must not be shared-cached. It needs no widget CSS or JavaScript.
+[Fields, filters and caching →](docs/wiki/Recent-comments.md)
+
 ### 4. Enable email and cleanup
 
+Version 0.2.0 includes minimal HTML emails with the site name, clear action
+links and equivalent plain text. Existing host email overrides take precedence.
+
 Configure Django's SMTP settings and schedule this once per minute:
 
 ```sh
@@ -169,22 +218,23 @@ cover the same topics. Start with the task you need:
 | Reader behavior | [Guests](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Guest-comments.md) · [Replies and editing](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Replies-and-editing.md) |
 | Customize | [CSS and themes](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Styling.md) · [Templates and email](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Templates.md) · [Python callbacks](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Callbacks.md) · [Django model adapters](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Object-adapters.md) |
 | Operate | [SMTP and worker](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Email-and-worker.md) · [Deployment](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Deployment.md) · [Security and privacy](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Security-and-privacy.md) |
-| Diagnose | [Troubleshooting / FAQ](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Troubleshooting.md) · [Example and testing](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Example-and-testing.md) |
+| Diagnose | [Troubleshooting / FAQ](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Troubleshooting.md) · [Example and testing](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Example-and-testing.md) · [Performance and load checks](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Performance.md) |
 
 ## Release scope and verification
 
-[0.1.0 release notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.1.0.md) describe the initial feature set and
-limits. The source distribution includes the runnable Wagtail example, tests and
+[0.2.0 Beta release notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.2.0.md) describe the changes and upgrade steps;
+[0.1.0 release notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.1.0.md) preserve the initial release contract.
+The source distribution includes the runnable Wagtail example, tests and
 guides; the wheel includes the runtime, translations, templates and static assets.
 
-CI checks six Python/database combinations, JavaScript, lint, migration drift,
+The CI workflow defines 30 framework/Python/database combinations, JavaScript, lint, migration drift,
 translations and source/wheel installation. Browser checks covered installed Safari,
 Chrome, Yandex Browser and Firefox with and without JS, plus selected VoiceOver
 scenarios and a phone. Previous major browser versions remain unverified; this is
 not an exhaustive accessibility or device certification.
 
 There is no separate REST API, rich-text editor, uploads, likes, reports or live
-updates in 0.1.0. SMTP retries can duplicate mail after an uncertain delivery result.
+updates in 0.2.0. SMTP retries can duplicate mail after an uncertain delivery result.
 Host-specific themes, access rules and email delivery need their own acceptance checks.
 
 ## Support Commentail

{commentail-0.1.0 → commentail-0.2.0}/README.md

@@ -7,6 +7,9 @@
 Moderated discussions, verified guests and inline replies — styled by your site.
 
 [![Tests and distributions](https://github.com/hardcodd/Commentail/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/hardcodd/Commentail/actions/workflows/tests.yml)
+[![Django Packages · Commentail](https://img.shields.io/badge/Django%20Packages-Commentail-0C4B33.svg)](https://djangopackages.org/packages/p/commentail/)
+
+English · [Русский](README.ru.md)
 
 [Get started](#quick-start) · [Documentation](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Home.md) · [Wiki](https://github.com/hardcodd/Commentail/wiki) · [Support](#support-commentail)
 
@@ -14,7 +17,7 @@ Moderated discussions, verified guests and inline replies — styled by your sit
 
 </div>
 
-Commentail is a Django comments library built for **Wagtail 7.4 LTS**. Add a
+Commentail is a Django comments library for **Wagtail 7.4 LTS and 8.0**. Add a
 Django template tag to an article, moderate discussions inside Wagtail, and keep
 content, accounts and email delivery in your own application.
 
@@ -22,7 +25,10 @@ The widget inherits your site's typography and colors. CSS custom properties,
 replaceable templates and Python callbacks let you adapt it without a frontend
 framework or an external comments platform.
 
-> Wagtail 8.0 is not supported by 0.1.0.
+> **0.2.0 Beta** adds recent comments, six languages,
+> HTML emails and indexed database reads.
+> [Version-to-version changelog](https://github.com/hardcodd/Commentail/blob/main/CHANGELOG.md) · [Roadmap](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Roadmap.md).
+> [Changes and upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.2.0.md).
 
 ## Why Commentail?
 
@@ -47,17 +53,32 @@ the visible text and author name. Choose either format or disable output in Pyth
 | Component | Version / requirement |
 | --- | --- |
 | Python | 3.12–3.14 |
-| Wagtail | >=7.4.3, <7.5 |
-| Django | >=5.2, <5.3 |
-| Database | SQLite or PostgreSQL; CI covers PostgreSQL 14 |
-| UI languages | English and Russian |
+| Wagtail / Django | 7.4.3+ in 7.4 / Django 5.2 or 6.0; 8.0.x / Django 5.2, 6.0 or 6.1 |
+| Database | File SQLite or PostgreSQL 16 |
+| UI and email languages | English, Russian, German, French, Spanish and Brazilian Portuguese |
 | Frontend | Django templates, optional progressive JavaScript |
 | License | [MIT](https://github.com/hardcodd/Commentail/blob/main/LICENSE) |
 
+This table describes the 0.2.0 Beta release. CI defines all five framework
+pairs on Python 3.12, 3.13 and 3.14 with both databases (30 combinations).
+Package bounds are `Wagtail>=7.4.3,<8.1` and `Django>=5.2,<6.2`; only the pairs
+listed above are supported. Wagtail 7.4 with Django 6.1 is outside this matrix.
+Wagtail 8.1 and later require separate verification before support is declared.
+
 Guest comments require configured SMTP and the scheduled worker. Registered
 users can comment without an email address, but receive no mail. Your site
 provides login and registration. No required external CDN or CAPTCHA service.
 
+### Languages
+
+Alongside English and Russian, 0.2.0 includes German (`de`), French (`fr`),
+Spanish (`es`) and Brazilian Portuguese (`pt-br`) for the public UI,
+moderation/settings and all notification emails.
+The host site selects the active Django language; queued emails retain the
+recipient's saved language. User comments and rejection reasons are not translated.
+Documentation remains in English and Russian.
+[Language configuration →](docs/wiki/Configuration.md#languages)
+
 ## Quick start
 
 ### 1. Install
@@ -65,16 +86,22 @@ provides login and registration. No required external CDN or CAPTCHA service.
 In your site's virtual environment, install the release:
 
 ```sh
-python -m pip install commentail==0.1.0
+python -m pip install commentail==0.2.0
 ```
 
-For the optional PostgreSQL driver, use `python -m pip install 'commentail[postgres]==0.1.0'`.
-You can also install a downloaded wheel directly, or extract the source distribution
-and run `python -m pip install .` in its root.
+For the optional PostgreSQL driver, use
+`python -m pip install 'commentail[postgres]==0.2.0'`.
+You can also extract the source distribution and run `python -m pip install .` in its root.
+When upgrading from 0.1.1, review the
+[upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.2.0.md),
+including migration `0014_reading_indexes` and email overrides. For older
+installations, also review the [0.1.1 notes](docs/releases/0.1.1.md). The 0.1.0 package retains
+its original Wagtail 7.4 and Django 5.2 limits.
 
 ### 2. Connect Django and Wagtail
 
 - Add `commentail` and `wagtail.contrib.settings` to your existing `INSTALLED_APPS`.
+- With PostgreSQL, also include `django.contrib.postgres` (required by Django 6.x checks).
 - Insert `commentail.middleware.CapabilityHeadersMiddleware` before CSRF middleware.
 - Retain the host session/authentication/messages middleware and template request context processor.
 - Include Commentail URLs **before** Wagtail's catch-all:
@@ -101,8 +128,28 @@ The template controls where Page comments are available; the corresponding Page
 editor receives a Comments tab. Configure site defaults, then inherit or override
 on individual Pages. **Review all** is the initial moderation policy.
 
+### Recent comments elsewhere
+
+Use the recent-comments tag on a home page, sidebar or another template:
+
+```django
+{% load commentail_tags %}
+{% commentail_recent limit=5 as recent_comments %}
+{% for comment in recent_comments %}
+  <a href="{{ comment.url }}">{{ comment.author_name }}: {{ comment.text|truncatechars:120 }}</a>
+{% endfor %}
+```
+
+Use `page=page` for one Page and `include_replies=False` for roots only. The list
+respects the current visitor's access and Site, requires a request context and
+must not be shared-cached. It needs no widget CSS or JavaScript.
+[Fields, filters and caching →](docs/wiki/Recent-comments.md)
+
 ### 4. Enable email and cleanup
 
+Version 0.2.0 includes minimal HTML emails with the site name, clear action
+links and equivalent plain text. Existing host email overrides take precedence.
+
 Configure Django's SMTP settings and schedule this once per minute:
 
 ```sh
@@ -143,22 +190,23 @@ cover the same topics. Start with the task you need:
 | Reader behavior | [Guests](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Guest-comments.md) · [Replies and editing](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Replies-and-editing.md) |
 | Customize | [CSS and themes](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Styling.md) · [Templates and email](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Templates.md) · [Python callbacks](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Callbacks.md) · [Django model adapters](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Object-adapters.md) |
 | Operate | [SMTP and worker](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Email-and-worker.md) · [Deployment](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Deployment.md) · [Security and privacy](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Security-and-privacy.md) |
-| Diagnose | [Troubleshooting / FAQ](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Troubleshooting.md) · [Example and testing](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Example-and-testing.md) |
+| Diagnose | [Troubleshooting / FAQ](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Troubleshooting.md) · [Example and testing](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Example-and-testing.md) · [Performance and load checks](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Performance.md) |
 
 ## Release scope and verification
 
-[0.1.0 release notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.1.0.md) describe the initial feature set and
-limits. The source distribution includes the runnable Wagtail example, tests and
+[0.2.0 Beta release notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.2.0.md) describe the changes and upgrade steps;
+[0.1.0 release notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.1.0.md) preserve the initial release contract.
+The source distribution includes the runnable Wagtail example, tests and
 guides; the wheel includes the runtime, translations, templates and static assets.
 
-CI checks six Python/database combinations, JavaScript, lint, migration drift,
+The CI workflow defines 30 framework/Python/database combinations, JavaScript, lint, migration drift,
 translations and source/wheel installation. Browser checks covered installed Safari,
 Chrome, Yandex Browser and Firefox with and without JS, plus selected VoiceOver
 scenarios and a phone. Previous major browser versions remain unverified; this is
 not an exhaustive accessibility or device certification.
 
 There is no separate REST API, rich-text editor, uploads, likes, reports or live
-updates in 0.1.0. SMTP retries can duplicate mail after an uncertain delivery result.
+updates in 0.2.0. SMTP retries can duplicate mail after an uncertain delivery result.
 Host-specific themes, access rules and email delivery need their own acceptance checks.
 
 ## Support Commentail