[alert_handler] Convert theory of operation to template

[a-will]

The theory of operation document referenced a particular instance's generated core's parameters in a table. Change the table header to not explicitly refer to Earl Grey and populate some of the values from template parameters.

Note: The conversion to Mako template caused lines beginning with # to become comments, so I have changed the syntax to use the HTML variant.

[a-will]

This was mostly motivated by a multi-top annoyance, where the new top still had Earl Grey references.

[hcallahan-lowrisc]

Table changes LGTM.

For the headings, you can use the trick in #3458

Thanks!

[msfschaffner]

We may have to pull in the top-name into IPgen in the future to uniquify generated IPs via a pre- or suffix (e.g. top_earlgrey_alert_handler, and that would allow us to create top-specific documentation in a somewhat more convenient way.

For now however I think this is perfectly fine.

[msfschaffner]

LGTM (modulo @hcallahan-lowrisc's suggestion)!

[a-will]

Table changes LGTM.

For the headings, you can use the trick in #3458

Thanks!

I don't see how wrapping the Markdown header shorthand in a <%text> Mako tag is any better than the unadulterated HTML / Markdown header tag, haha. But if that's the preference, it's no problem!

[a-will]

Table changes LGTM.
For the headings, you can use the trick in #3458
Thanks!

I don't see how wrapping the Markdown header shorthand in a <%text> Mako tag is any better than the unadulterated HTML / Markdown header tag, haha. But if that's the preference, it's no problem!

Ah, it does minimize the diff for the generated core doc, though. :)