simplifying <articleinfo> and <bookinfo> sections

Matthew East mdke at ubuntu.com
Sun Dec 3 18:38:11 UTC 2006


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

While playing around in the topic-based-help branch, I thought that if
we're going to have a lot of different documents, it would be convenient
to have a simpler more automated way of writing <articleinfo> and
<bookinfo> sections.

Instead of writing them for each document, we can simply call entities
which bring up the same thing each time. See how it works here:

https://docteam.ubuntu.com/repos/branches/topic-based-help/ubuntu/C/add-applications/add-applications.xml

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.

Matt
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.3 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFFcxmTtSaF0w5rBv8RAlpZAJ9SrrRyiDAb73V61OG1IX7sEuqPtACfWDNG
ZPFqhmDp/EbUkMOktyh5XpM=
=wd3I
-----END PGP SIGNATURE-----




More information about the ubuntu-doc mailing list