[
https://issues.apache.org/jira/browse/DOXIA-754?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17891888#comment-17891888
]
Michael Osipov commented on DOXIA-754:
--------------------------------------
I would opt for the explicit nested lists. Everything shall either fail or be
undefined.
> Clarify Sink method order for nested lists
> ------------------------------------------
>
> Key: DOXIA-754
> URL: https://issues.apache.org/jira/browse/DOXIA-754
> Project: Maven Doxia
> Issue Type: Improvement
> Components: Core
> Reporter: Konrad Windszus
> Priority: Major
>
> From the [Sink Javadoc of
> list()|https://maven.apache.org/doxia/doxia/doxia-sink-api/apidocs/org/apache/maven/doxia/sink/Sink.html#list-org.apache.maven.doxia.sink.SinkEventAttributes-]
> (or the other related list methods) it is not clear how to properly nest
> lists/list items
> There are different options:
> {code}
> list();
> listItem();
> text("level 1")
> listItem();
> text("level 1.1")
> listItem_();
> listItem_();
> list_();
> {code}
> or
> {code}
> list();
> listItem();
> text("level 1")
> list();
> listItem();
> text("level 1.1")
> listItem_();
> list_();
> listItem_();
> list_();
> {code}
>
> This should be clarified, so that it is clear for both Sink impls as well as
> Sink API users which order to expect/use.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
