simplifying <articleinfo> and <bookinfo> sections
Richard Johnson
nixternal at ubuntu.com
Tue Dec 5 13:15:47 UTC 2006
On Sunday 03 December 2006 12:38, Matthew East wrote:
[snip]
| What do people think about standardising these sections for *all* of our
| documents in this way? We could have a standard list of contributors for
| all documents (common/C/contributors.xml) which is called for all the
| documents. The disadvantage is that the reader doesn't get to see who
| works on each individual document, but the advantage is its simpler to
| implement documents and that everyone is credited for their contribution
| to {*}Ubuntu documentation, regardless of where they contributed.
You could create the contributors file modeled from the DocBook book with the
<authorgroup> info.
----------------------------
<!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<authorgroup>
<author>
<firstname>Matthew</firstname>
<surname>East</surname>
<affiliation>
<shortaffil>Ubuntu Documentation Project Leader</shortaffil>
<orgname>The Ubuntu Documentation Project</orgname>
</affiliation>
<authorblurb>
<para>
Matthew is the Documentation Project's sabdfl.
</para>
</authorblurb>
</author>
<editor>
<firstname>Feisty</firstname>
<surname>Fawn</surname>
<authorblurb>
<para>
Feisty Fawn has edited, proofread, and contributed in his spare time.
</para>
</authorblurb>
</editor>
</authorgroup>
----------------------------
Put the Doc Team members as authors, and everyone else as editors. If
members/authors want themselves labeled with the different guides they have
contributed to, then they can add it in an <authorblurb>. How would something
like this work out?
--
.:Richard Johnson
.:nixternal at ubuntu.com
.:ubuntu.com .:kubuntu.com .:edubuntu.com .:xubuntu.com
.:http://nixternal.ubuntu-rocks.org
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20061205/724a0f8e/attachment.pgp>
More information about the ubuntu-doc
mailing list