Re: Please look at your groups' charters rendered through markdown

[Mark Nottingham <[e-mail]>]

This looks great!

The only thing I see that might be worth considering is adjusting so that when a level-1 header is used in a charter, it's appropriately sized (smaller than currently), because it's not the top-level header on the page.

IMO we should avoid lots of one-off hacks / pre-processing in the markdown -- instead, we should fix the source files.

I think you hit the nail on the head of the real issue underlying this: what flavour of md to use. Lots of people are familiar with GFM, as well as kramdown (thanks to cabo's tooling). It'd be nice not to have to mode switch to a third variety, so a subset of one of those would probably be best (assuming we're eventually going to use the same flavour across charters, minutes, agendas, etc.).

Cheers,


> On 21 Sep 2021, at 3:34 am, Robert Sparks <[e-mail]> wrote:
> 
> Chairs -
> 
> I have added a page that shows how the current charter for a group renders with markdown, comparing side-by-side with the current rendering.
> 
> See, for example, https://datatracker.ietf.org/group/stir/about/rendertest/
> 
> Please look the variant of that page for all of the groups you are responsible for (and feel free to explore others).
> 
> Bring any issues with the markdown rendering of the current charter text to me.
> 
> If we don't have major issues to address with any existing charter text, I plan to switch the main /about page (and the charter document view page) to render through markdown with the next datatracker release.
> 
> RjS
> 

--
Mark Nottingham   https://www.mnot.net/