Re: RFCs should be distributed in XML (Was: Faux Pas -- web publication in proprietary formats at ietf.org

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Fri, Nov 18, 2005 at 09:13:33AM +0100, Juergen Schoenwaelder wrote:
> On Thu, Nov 17, 2005 at 09:22:10AM -0800, Ted Faber wrote:
> > 
> > Getting anyone to change their authoring tool is difficult, so hoping
> > for standardization on CVS input is pretty unlikely.  In my experience,
> > IETF contributors are an order of magnitude more stubborn than most
> > authors, but even if that estimate's wrong, I think there's a lot of
> > inertia here.
> > 
> > One way forward is to put the CVS/RFC2XML system up and hope people
> > migrate for the advantages.  I'm not optimistic, though I happily use
> > both tools.
> 
> Clarification #1: I believe the IETF (tools team perhaps) should
> provide version control services (again I favour SVN over CVS but that
> is an implementation detail) for WGs who _want_ to use it. Much like
> xml2rfc is out there for authors/editors who _want_ to use it.

I think we agree on that.  In fact I think we're in general agreement,
but some of the details differ.

>                                                                I
> request that the RFC editor will accept xml2rfc as an input format.

I thought they did take it as a supplement or something, which I hope
indicates that they are considering moving to it.  

> See also Bert Wijnen's early copy editing experiment where they seem
> to have used xml2rfc successfully for copy editing. In other words,
> the proposal is not to force people who strongly believe in other
> tools to use xml2rfc or the repository. However, I believe having
> support for xml2rfc plus revision will be a big step for the community
> which already uses the xml2rfc format and is kind of happy with it.

I agree that this is a great goal.  But there are certainly going to be
people who are not going to do it.  I dunno why either - the advantages
seem considerable and obvious to me, too.

> 
> BTW, does the RFC editor have a record which typesetting system has
> recently been used to produce the documents that end up on his desk?

I don't know.  They (the RFC Editor is many people, many of whom aren't
he's :-)) may not get that information at all.  I agree it would be
interesting to know.

> > Again, let me be precise: I love, produce, use and delight in open
> > source software.  I've even documented some.  But as a whole, saying
> > that open source documentation is no great model of clarity,
> > completeness, consistency or even presence is being very polite.
> 
> Clarification #2: I did not think of open source documentation - I was
> referring to the source code itself. I believe there is no fundamental
> difference between the production of source code and technical
> specification when it comes to the importance of change management,
> style guides, bug tracking and long term evolution and maintenance of
> revision history. In other words, I believe that an IETF WG needs
> almost exactly the same tool chain, namely agreement on common
> formats, revision control, bug tracking.

Again, in the big picture we agree.  The IETF needs to keep track of
document revisions, bugs (outstanding issues), and produce consistent
documents.

I think that RFC formats and the RFC editor do establish a style guide.
I don't think you like the style that's being enforced, but I think
there is a (fairly consistent) style in force.  xml2rfc on the front end
and the backend idnits checker from the tools team help automate
following that style.  They're collectively indent(1) Or maybe lint(1)
for RFCs.

I think the bug tracking is addressed significantly by the issue
tracker.  Specs and implementations aren't the same and I don't think a
bug tracker with trouble tickets and all that is really what we need,
but I could be convinced.  I'm curious if you think the issue tracker
tool needs extending or scrapping.

I do agree that fine grained source control would be nice and if the
IETF wants to run a community source control system, I think that
would be a valuable resource.  I'm cautious that there might be a morass
here in picking the system, but if someone on the tools team just does
it, that may avoid the rathole simply.

Sorry if I misrepresented your position earlier.

-- 
Ted Faber
http://www.isi.edu/~faber           PGP: http://www.isi.edu/~faber/pubkeys.asc
Unexpected attachment on this mail? See http://www.isi.edu/~faber/FAQ.html#SIG

Attachment: pgpzBXndyVaKy.pgp
Description: PGP signature

_______________________________________________

Ietf@xxxxxxxx
https://www1.ietf.org/mailman/listinfo/ietf

[Index of Archives]     [IETF Annoucements]     [IETF]     [IP Storage]     [Yosemite News]     [Linux SCTP]     [Linux Newbies]     [Fedora Users]