runbot/runbot_merge/changelog/2024-08/description.md

IMP: PR descriptions are now markdown-rendered in the dashboard

Previously the raw text was displayed. The main advantage of rendering, aside
from not splatting huge links in the middle of the thing, is that we can
autolink *odoo tasks* if they're of a pattern we recognize. Some support has
also been added for github's references to mirror GFM rendering.

This would be a lot less useful (and in fact pretty much useless) if we could
use github's built-in [references to external resources](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/configuring-autolinks-to-reference-external-resources)
sadly that seems to not be available on our plan.
[ADD] runbot_merge: rendering of PR descriptions Previously PR descriptions were displayed as raw text in the PR dashboard. While not wrong per se, this was pretty ugly and not always convenient as e.g. links had to be copied by hand. Push descriptions through pymarkdown for rendering them, with a few customisations: - Enabled footnotes & tables & fenced code blocks because GFM has that, this doesn't quite put pymarkdown's base behaviour on par with gfm (and py-gfm ultimately gave up on that effort moving to just wrap github's own markdown renderer instead). - Don't allow raw html because too much of a hassle to do it correctly, and very few people ever do it (mostly me I think). - Added a bespoke handler / renderer for github-style references. Note: uses positional captures because it started that way and named captures are not removed from that sequence so mixing and matching is not very useful, plus python does not support identically named groups (even exclusive) so all 4 repo captures and all 3 issue number captures would need different names... - And added a second bespoke handler for our own opw/issue references leading to odoo.com, that's something we can't do via github[^1] so it's a genuine value-add. Fixes #889 [^1]: github can do it (though possibly not with the arbitrary unspecified nonsense I got when I tried to list some of the reference styles, some folks need therapy), but it's not available on our plan 2024-07-11 16:53:01 +07:00			`IMP: PR descriptions are now markdown-rendered in the dashboard`

			`Previously the raw text was displayed. The main advantage of rendering, aside`
			`from not splatting huge links in the middle of the thing, is that we can`
			`autolink odoo tasks if they're of a pattern we recognize. Some support has`
			`also been added for github's references to mirror GFM rendering.`

			`This would be a lot less useful (and in fact pretty much useless) if we could`
			`use github's built-in [references to external resources](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/configuring-autolinks-to-reference-external-resources)`
			`sadly that seems to not be available on our plan.`