There are several ways that these folks, as well as other contributors to your document, can be given some recognition for the help they've given you.
All translators, converters and co-authors should be credited with an <othercredit> tag entry. To properly credit a translator or converter, use the <othercredit> tag with the role attribute set to "converter" or "translator", as indicated in the example below:
Within the <revision> tag hierarchy is a tag called <revremark>. Within this tag, you can make any brief notes you wish about each particular revision of your document.
The <revhistory> tag should be used to denote the various revisions of the document. Specify the date, revision number and comments regarding what has changed.
Revisions should be listed with the most-recent version at the top (list in descending order).
The <pubdate> tag in your header should list the publication date of this particular version of the document (coincide with the revision date). It should be in the following format:
<pubdate>2002-04-25</pubdate> |
The date is in the format YYYY-MM-DD, which is one of the ISO 8601 standard formats for representing dates. For you Yanks out there (me too), think of it as going from the largest unit of time to the smallest.
Here is a sample of a complete DocBook (SGML or XML) <articleinfo> element which contains some of the items and constructs previously described.
Example D-10. Sample Meta Data
<!--
Above these lines in a typical DocBook article would be the article
element (the immediate parent of the articleinfo element) and above
that typically, the DOCTYPE declaration and internal subset.
-->
<articleinfo>
<!--
Use "HOWTO", "mini HOWTO", "FAQ" in title, if appropriate
-->
<title>Sample HOWTO</title>
<author>
<firstname>Your Firstname</firstname>
<surname>Your Surname</surname>
<affiliation>
<address><email>your email</email></address>
</affiliation>
</author>
<editor>
<firstname>Tabatha</firstname>
<surname>Marshall</surname>
<contrib>Language review of version 0.8</contrib>
</editor>
<othercredit role='converter'>
<firstname>David</firstname>
<surname>Merrill</surname>
<contrib>Conversion from HTML to DocBook v3.1 (SGML).</contrib>
</othercredit>
<pubdate>YYYY-MM-DD</pubdate>
<revhistory>
<revision>
<revnumber>1.0</revnumber>
<date>YYYY-MM-DD</date>
<authorinitials>ABC</authorinitials>
</revremark>first official release</revremark>
</revision>
<revision>
<revnumber>0.9</revnumber>
<date>YYYY-MM-DD</date>
<authorinitials>ABC</authorinitials>
<revremark>First draft</revremark>
</revision>
</revhistory>
<!--
Provide a good abstract; a couple of sentences is sufficient
-->
<abstract>
<para>
This is a sample DocBook (SGML or XML) HOWTO which has been
constructed to serve as a template.
</para>
</abstract>
</articleinfo>
|