ietf
[Top] [All Lists]

RE: Last Call: draft-harrington-text-mib-doc-template (A Template

2007-02-16 16:16:41
Hi,

Yup. 
Trying to figure out how to publish this in an internet-draft has been
challenging to say the least.
(publishing the xml2rfc template in an xml2rfc document is even more
challenging!)
The template, in both text and xml2rfc format, has been available on
the OPS website since July.  

Thanks for the suggestion of using an appendix; I'll consider that
possibility.

dbh

-----Original Message-----
From: Tom.Petch [mailto:sisyphus(_at_)dial(_dot_)pipex(_dot_)com] 
Sent: Friday, February 16, 2007 8:14 AM
To: ietf
Subject: Re: Last Call: 
draft-harrington-text-mib-doc-template (A Template

I think that the idea behind this draft is a good one but 
that the choice of
technology is wrong.

The template should be on a web site available for download 
and that the way to
get it there is the same as is used eg to get SMI TCs on to a 
website, namely
publish it as an appendix to an RFC, so the body of the RFC 
is a proper RFC,
formatted as usual, with the usual genuine comments to the 
RFC Editor, IANA etc
and the appendix is then labelled 'do not touch' as far as 
RFC Editor, IANA etc
are concerned and provides the material which will be loaded 
on to the website.

The Appendix would benefit from a convention so show that the 
sections therein
are at a second level, eg a marking or escape character 
before each section
head, which is removed when the Appendix is placed on to the web
site.

The current approach of interleaving what will appear in the 
template, comments
thereon and the normal RFC material is likely to confuse all 
who come after.

Tom Petch


_______________________________________________
Ietf mailing list
Ietf(_at_)ietf(_dot_)org
https://www1.ietf.org/mailman/listinfo/ietf




_______________________________________________
Ietf mailing list
Ietf(_at_)ietf(_dot_)org
https://www1.ietf.org/mailman/listinfo/ietf

<Prev in Thread] Current Thread [Next in Thread>