ietf-tools / datatracker

The day-to-day front-end to the IETF database for people who work on IETF standards.
https://datatracker.ietf.org
BSD 3-Clause "New" or "Revised" License
525 stars 313 forks source link

Minor hedgedoc / minutes-import disagreement on ```language #7594

Open chrysn opened 1 week ago

chrysn commented 1 week ago

Describe the issue

On a second look at today's CBOR minutes I saw that the hedgedoc import was not 100% correct:

"Source code" in hedgedoc:

```cddl
envelope-content =
    leaf /
    elided /
    node /
    assertion /
    wrapped

leaf = #6.201(any)
```

Rendition in hedgedoc's view mode: pre-formatted, just the content (the cddl wasn't interpreted to really good syntax highlighting, but it was more for the benefit of the readers anyway)

Rendition in the imported notes: There is an extra line after the pre-formatted text: {: .language-cddl}

This is a really small issue, might just as well be fine to just accept it until that markdown part is next updated for other reasons – thanks for already making that import super smooth!

Code of Conduct

cabo commented 1 week ago

One problem is that `` is not standard markdown. So the processor might be interpreting this as a code span (foo`), not a code block (which would be

foo

).

jennifer-richards commented 1 week ago

The actual imported file looks like:

## Does a generic "none of the above" tag make sense?   {#does-a-generic-none-of-the-above-tag-make-sense}

dcbor asks for tag, uses it in draft-mcnally-envelope to disambiguate

    envelope-content =
        leaf /
        elided /
        node /
        assertion /
        wrapped

    leaf = #6.201(any)
{: .language-cddl}

CA: Had similar pattern in earlier iterations of CoRAL – generic thing,