This is the parent task for documentation updates for the new hook system based on Hook Container.
To do: Pilot
3 story points:
- Update hooks manual on mediawiki.org with intro section (T250754) (Nikki and Alex)
- Add interfaces to individual hook pages on mediawiki.org (T250757) (Alex)
- Create architecture documentation (https://gerrit.wikimedia.org/r/c/mediawiki/core/+/593982) (Tim)
- Send announcement about changes to hook behavior in Core to wikitech-l following merging of key patches (Tim)
- Troubleshoot group docs on Doxygen to create a list of available hooks (T253815) (Alex)
1-2 story points:
- Update docs section on https://www.mediawiki.org/wiki/Manual:Hooks (Alex)
- Search mediawiki.org for references to hooks.txt and update (Alex)
- Update https://www.mediawiki.org/wiki/Manual:Extension.json/Schema#Hooks (Alex)
- Add callout on hooks.txt that points to the new system and redirects updates to hook interfaces (https://gerrit.wikimedia.org/r/c/mediawiki/core/+/593982) (Tim)
To do: After migrating a few extensions and after release of 1.35
- Update https://www.mediawiki.org/wiki/Manual:Developing_extensions
- Finish updates to individual hook pages on mediawiki.org (T250757)
- Finish updating hooks manual on mediawiki.org (T250754)
- Update https://www.mediawiki.org/wiki/Extension:BoilerPlate and https://www.mediawiki.org/wiki/Extension:Example (T254381) (Nikki)
- Open a task summarizing our thoughts on creating a system that pulls documentation from hook interfaces into individual hook wiki pages (Example using extension data: https://www.mediawiki.org/wiki/Module:ExtensionJson), including auditing docs in the individual hook pages for additional content and managing translation (Alex)