cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Stefano Mazzocchi <>
Subject Re: [doc] how to use fixme?
Date Tue, 04 Jun 2002 09:26:11 GMT
Diana Shannon wrote:
> I'm trying to understand how best to use the fixme element for adding
> comments to docs, either for authors who are willing to update their own
> work or for problems I cannot solve, at least on the first pass.
> I notice fixme has a required author attribute. In document-v10.dtd, it
> states:
>     the "author" attribute should match the "key" attribute of the
> <author> element
> I assume this means the attribute id of a person element listed under
> document/header/authors/person. Still, I don't want to add my name as an
> author to each and every document which simply needs my fixme comments.

Hmmmm, good point.

> Should I simply use the id of the existing person listed under authors?

No, that's against the idea of fixme.

Yes, we should use something like a map (doesn't need to be a 'topic
map' to be honest)... the best thing would be to have the DTD aggregate
the committers list... but I'm not sure how to do it (and I'm not a DTD
guru, to be honest).

Suggestions anyone?

Stefano Mazzocchi      One must still have chaos in oneself to be
                          able to give birth to a dancing star.
<>                             Friedrich Nietzsche

To unsubscribe, e-mail:
For additional commands, email:

View raw message