[publican-list] [Bug 480721] Banned tags and translations considerations need to be added to Users Guide

[bugzilla at redhat.com]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.


https://bugzilla.redhat.com/show_bug.cgi?id=480721





--- Comment #1 from Brian Forte <bforte at redhat.com>  2009-01-20 00:50:51 EDT ---
Urtext for this is on the ECS wiki at
<https://engineering.redhat.com/trac/ContentServices/wiki/WhichXMLTagsShouldINotUse>

Note to self: bforte also has a ready-to-roll XML version of the above stored
locally:
~/documents/red
hat/svn/Internal/5.0/Style_Guide/en-US/Which_XML_Tag_Should_I_Use.xml

Other notes to add to this (from irc discussions with jfearn):

All questions of the reasoning behind this aside, banning attributes like
xreflabel has the following practical consequence:

<chapter id="ch03">
 <title>The Secret to Eternal Life</title>
 <para>The secret to eternal life is…</para>
</chapter>

[more deathless prose here]  

…see >xref linkend="ch03"> for details.

Will be transformed into HTML such that the displayed text of the resultant
anchor tag is and can only be ‘Chapter 3: The Secret to Eternal Life’.

That is, you can’t change the xref’s linkend title (so to speak).

-- 
Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are on the CC list for the bug.