Re: [rfc-i] [Rsoc] RFCs with page numbers (pretty please) ?

[tom petch <[e-mail]>]

<inline a query on v3>

On 02/11/2020 12:37, Julian Reschke wrote:
> Am 02.11.2020 um 13:17 schrieb tom petch:
>> ...
>> It is like writing anything in code, modular is better than spaghetti,
>> but there is a limit to how far that can go without creating a spiders
>> web of interconnections between modules.  The i2nsf I-D I just looked at
>> is 55 pages split into three modules and I would not subdivide it any
>> further.  YANG modules must be self-contained and comprehensible,
>> independent of the RFC they come from so in a well written one, a large
>> part with be text description; and the whole idea of YANG was that it be
>> text-based, unlike the binary encoding of SNMP, so you have text
>> identifiers, type, references to RFC, IANA etc.  It all mounts up.  Five
>> pages would be very small.
>> ...
>
> I'll assume the example is
> <https://www.ietf.org/archive/id/draft-ietf-i2nsf-nsf-facing-interface-dm-10.txt>?
>
>
> What you could do now: split the module into top-level artefacts and
> place them into separate <sourcecode> elements. These can have anchors
> the split tool could generate. Thus each of the pieces would have an
> anchor you can link to.
>
> What might be desirable as xml2rfc feature: the ability to add line
> numbers to <sourcecode>.
>
> I do understand that both would interfere with extraction code that has
> been written for plain text, but that should not be needed/used anymore
> in the v3 xml world anyway.

That I do not understand.  What is different with the v3 xml world that 
the extraction code is not needed?  And is this also true for the checks 
that are performed on YANG modules that they 'compile' ok which I think 
are done automativally when a I-D with a YANG module in it is submitted 
(it is a while since I submitted an I-D with a YANG module it it)?

Tom Petch

> Best regards, Julian
> .
>
_______________________________________________
rfc-interest mailing list
[e-mail]
https://www.rfc-editor.org/mailman/listinfo/rfc-interest