[jira] [Commented] (DOXIA-754) Clarify Sink method order for nested lists

["Michael Osipov (Jira)" <ji...@apache.org>]

    [ 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)