[DOXIA-138] Review and clarify the APT guide

• Type: Task
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.0-alpha-8
• Fix Version/s: 1.1
• Component/s: Documentation, Module - Apt
• Assignee: Lukas Theussl
• Reporter: Lukas Theussl
• Created: 18/Jul/07 01:57
• Updated: 07/Apr/15 18:15
• Resolved: 16/Feb/08 08:28

Description

Our current apt guide is a copy of http://www.xmlmind.com/_aptconvert/docs/userguide2.html, but there are several issues that need clarification, eg

• case sensitivity and white space handling in anchors
• anchors for section titles
• figure handling, esp extensions
• tables: is the first line always a header row?

Some of these depend on how things are going to be implemented.

We also decided to remove the apt guide at http://maven.apache.org/guides/mini/guide-apt-format.html and only keep the one on the doxia site.

Issue Links

• relates to: DOXIA-266 Section titles are not becoming anchors.