multi-part examples should be organized by group

[fmatter]

The current way to render a multi-part example is [ex](example-1,example-2) (or [](ExampleTable#cldf:__all__?ids=example-1,example2)).

This setup may not be intuitive for some writers, it's not possible to pass example-specific parameters (title, comment...), and I've found myself getting lost in the comma-separated list. S. Nordhoff suggested using a group with individual examples inside; I think something along these lines would make sense:

/// examples
[ex](example-1?options=blabla)
[ex](example-2?options=blabla)
///

Thought on this @xrotwang?

[xrotwang]

In "pure" CLDF Markdown, there's no way for the renderer to know multiple examples belong together if they are coded as individual links (i.e. the second block above). But pylingdocs could support a convention, where the link label (ex above) is interpreted as grouping key. So, authors would use your second option, and pylingdocs would convert this to the "one link" markup.

[fmatter]

What do you mean by grouping key?

[xrotwang]

pylingdocs could understand that the two examples

[ex](example-1?options=blabla)
[ex](example-2?options=blabla)

should be rendered as group, because both have the label ex.

[fmatter]

Ah, I see. Since you need to be able to add a title to the entire multi-part example I will probably just go with some variation of the block notation above (so that arguments can be passed), and preprocess it into a single [ex].