Re: [rfc-i] The role of txt format in ietf document development

[Carsten Bormann <[e-mail]>]

On 2020-10-29, at 12:41, Michael Richardson <[e-mail]> wrote:
> 
> Signed PGP part
> 
> Martin Thomson <[e-mail]> wrote:
>> However, I still find that people routinely refer to the rendered
>> versions.  Many outside reviews refer to text by section numbers (which
>> is not in the source, ouch).  For people working on QUIC, we've mostly
> 
> Yes. That's really an annoyance.  In XML land how many of us have:
> 
>   <!-- section 4.5.6 -->
>   <section title="FOO" ..>
> 
> I don't know how to do this in markdown, as there isn't really a useable
> comment system, except using XML.

But using XML is the markdown comment system.
(Except that it inherits the inability to have double-hyphens in comments; kramdown therefore has {::comment}…{:/} as well.)

More interesting is the question whether we can get editors (such as markdown-mode in Emacs) to display the current section number or visit a given one.  SMOP (*); highlighting already knows the section headers, so it’s a matter of counting them.

>> moved to direct references to the editor's copy.  The addition of
>> pilcrows on paragraphs has been a huge help in improving our ability to
>> reference text.  I wish that we could teach more people to do that.
> 
> I'm confused: what is it that we need to teach?

Sending precise links instead of phrasing the reference in English.

It would be nice if there were a less contorted way to actually open the HTML for a document so you can link to places inside it; right now that is 3 or 4 klicks, most of which have a 6-second wait for datatracker.

Grüße, Carsten

(*) Yeah, I know.  Probably a day.

_______________________________________________
rfc-interest mailing list
[e-mail]
https://www.rfc-editor.org/mailman/listinfo/rfc-interest