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