[
http://jira.codehaus.org/browse/DOXIA-138?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_107071
]
Denis Cabasson commented on DOXIA-138:
--------------------------------------
Section titles as anchors are definitely not a good idea.
My point was only to review the documentation and see where the documentation
and DOXIA weren't consistants.
The way it is done in xdoc is quite good actually. Currently my problem with
anchors is that you can't create an anchor without any text, which would be
handy to refer to a section. There are times when I don't want the anchor id
(which can be kind of unreadable) to be displayed to the end user.
> Review and clarify the APT guide
> --------------------------------
>
> Key: DOXIA-138
> URL: http://jira.codehaus.org/browse/DOXIA-138
> Project: Maven Doxia
> Issue Type: Task
> Components: Documentation, Module - Apt
> Affects Versions: 1.0-alpha-8
> Reporter: Lukas Theussl
> Fix For: 1.0
>
>
> 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.
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
