Re: Waiting for feedback about issues with the Docutils Doctree [#489]

Since I have not seen any developer feedback,
here is some user feedback.

- citations without content: I've never seen it
- footnotes without content or without "label": I've never seen it
- figures without caption/legend: no "legend" is reasonably common, but no
caption is extremely rare and is a need met by `image` (I believe)

Cheers, Alan Isaac



On Mon, Jun 17, 2024 at 12:45 PM Guenter Milde via Docutils-develop <
[email protected]> wrote:

> Dear Docutils Developers,
>
> I still hope to get some feedback on what to do with the discrepancies of
>
> * user documentation
> * Docutils Generic Document Type Description (docutils.dtd), and
> * "rst" parser behaviour.
>
>
> Footnotes and Citations
>   may be specified **without content** in rST without the parser
> complaining.
>
>   According to documentation and docutils.dtd content is required.
>
>   → Is there any use-case for empty footnotes or citations?
>
> Footnote label
>   is optional according to docutils.dtd
>
>   According to user documentation, a label is required.
>   The "rst" parser requires a label, too.
>
>   → Is there any use-case for a footnote without label?
>
>
> Figures
>   require a caption or legend according to docutils.dtd.
>
>   The "rst" parser and the documentation allow figures without caption or
>   legend.
>
>   → OK to Allow figures without caption/legend in the Docutils Generic DTD?
>
>
> See also https://sourceforge.net/p/docutils/bugs/489/
>
>
> Günter
>
>
>
> _______________________________________________
> Docutils-develop mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/docutils-develop
>
> Please use "Reply All" to reply to the list.
>