Automatic documentation generation

[gersona]

• fixes Automate documentation updates (add-ons, machinery, checks) #17761

The approach is to use markers in the target document in order to combine automatically generated content (within the markers) and custom/handwritten content.
This has is drawbacks, but it allows to keep a minimal number of files to maintain, and reduces mix of concern between documentation code and actual logic code.

[gersona]

@nijel, can you share your thoughts on this approach for automating documentation generation ?

[codecov]

Codecov Report

❌ Patch coverage is 83.51648% with 15 lines in your changes missing coverage. Please review.
✅ Project coverage is 92.00%. Comparing base (7e2c4f8) to head (dc20e72).
⚠️ Report is 3 commits behind head on main.

Files with missing lines	Patch %	Lines
weblate/addons/management/commands/list_addons.py	72.22%	12 Missing and 3 partials ⚠️

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[nijel]

I think it's a reasonable approach. See a few comments I've made on the implementation. I will also trigger copilot review to comment on this.

[Copilot]

Pull request overview

Adds scaffolding for automatic documentation generation by introducing version metadata markers for add-ons and updating the list_addons management command to emit/insert auto-generated RST blocks.

Changes:

• Introduced RST “versionadded/versionchanged” metadata helper classes and attached version metadata to various add-ons.
• Extended ./manage.py list_addons to write generated docs either to stdout or into a file section delimited by markers.
• Added human-readable descriptions for add-on events to improve generated documentation.

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
weblate/utils/docs.py	Adds RST version metadata helpers for embedding versionadded/versionchanged directives.
weblate/addons/base.py	Introduces doc_versions on add-on base class for documentation metadata.
weblate/addons/webhooks.py	Adds doc_versions metadata to webhook add-ons.
weblate/addons/gettext.py	Updates add-on description formatting and adds versionchanged metadata.
weblate/addons/generate.py	Adds versionadded metadata for locale-generation add-ons.
weblate/addons/fedora_messaging.py	Adds versionadded metadata for Fedora Messaging add-on.
weblate/addons/cleanup.py	Adds versionadded metadata for Remove Blank add-on.
weblate/addons/cdn.py	Adds versionadded metadata for CDNJS add-on.
weblate/addons/events.py	Adds event description strings used in generated docs.
weblate/addons/management/commands/list_addons.py	Adds marker-based insertion into an output file and restructures doc generation output.