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.