We’ve installed a bot to watch pull requests that make changes to documentation files, especially aimed at Architectural Decision Records. ADRs are short documents to capture important decisions. To keep the process lightweight, there is no manual announcement of these documents. The bot is meant to fill that gap by notifying when it notices changes to .rst or .md files that could be ADRs.
Thanks to @guruprasad from OpenCraft for writing the code, and for patience while I got it deployed
The notifications are being sent two places: the #adr-notifications channel in the Open edX Slack, and by email to the email@example.com mailing list in Google Groups. You can join the Google Group to receive emails directly if that is your jam.
There might be more notifications than desired at first, as we fine-tune the filters. Feedback welcome, of course!