napoleon
napoleon copied to clipboard
Compact literal blocks in examples
Is there any way to create example sections with short code blocks? I.e.
Examples::
a + b == c
For now, :: is not parsed as proper section, without this, docs looks awful, there's either
Examples:
unneeded comment::
a + b == c
or
Examples:
.. code-block::
a + b == c
Hi, ReST code block is smart, i.e.
Examples:
::
a + b == c
Well, yes, :: is parsed in the same way as .. code-block::, but it's still looks ugly, considering whole idea behind human-centric documentation. IMO.