[xml2rfc] feature request for tagging publication related information

julian.reschke@gmx.de (Julian Reschke) Thu, 13 November 2003 09:20 UTC

From: julian.reschke@gmx.de
Date: Thu, 13 Nov 2003 10:20:24 +0100
Subject: [xml2rfc] feature request for tagging publication related information
In-Reply-To: <20031112172615.64babeee.mrose+internet.xml2rfc@dbc.mtview.ca.us>
References: <Pine.LNX.4.44.0311112334190.1650-100000@netcore.fi> <Pine.BSF.4.53.0311111441140.83878@measurement-factory.com> <20031111161750.2d5cd9ee.mrose+internet.xml2rfc@dbc.mtview.ca.us> <Pine.BSF.4.53.0311111520230.83878@measurement-factory.com> <20031112215912.GH2596@sbrim-w2k01> <Pine.BSF.4.53.0311121500210.23426@measurement-factory.com> <20031112171006.29e6072d.mrose+internet.xml2rfc@dbc.mtview.ca.us> <3FB2C05D.1040605@gmx.de> <20031112172615.64babeee.mrose+internet.xml2rfc@dbc.mtview.ca.us>
Message-ID: <3FB34CD8.7070005@gmx.de>

Marshall Rose wrote:

>>Re: issue tracking. I think this is useful as well, and my rfc2629.xslt 
>>already supports some kind of "poor man's change and issue" tracking. 
>>Those who haven't seen that yet may want to check out the XML and HTML 
>>examples on <http://greenbytes.de/tech/webdav/>.
> 
> 
> can you point to one representative file?

Sure:

<http://greenbytes.de/tech/webdav/draft-ietf-webdav-acl-latest.xml>
<http://greenbytes.de/tech/webdav/draft-ietf-webdav-acl-latest.html>
<http://greenbytes.de/tech/webdav/draft-ietf-webdav-acl-latest.txt>

Basically I have

1) issue tracking: ed:issue (with entry and resolution sub-elemenents) and
2) change tracking: ed:ins/ed:del (with an ed:replace container)

Issues have hrefs (for instance, mailing list entry), identifiers, 
dates...; changes keep track of when, why (link to issue), who entered it...

The format works for me but probably is hard to handle for those who 
don't spend as much time with XML as I do. It's greatest benefits are:

- issues and change tracking embedded
- when releasing a new I-D, I can automatically remove all ed:del 
artifacts and all closed issues
- I can generate an appendix summarizing open and closed issues for this 
draft
- automatical generation of stand-alone issues document, such as 
<http://greenbytes.de/tech/webdav/draft-ietf-webdav-acl-issues.html>


I am mentioning this to illustrate that it may make sense to implement 
this kind of stuff outside of xml2rfc (with a conversion option to 
"plain" xml2rfc format). This allows playing around with the format 
without having to worry too much about backwards compatibility...

Julian

-- 
<green/>bytes GmbH -- http://www.greenbytes.de -- tel:+492512807760