On Thu, Apr 16, 2020 at 12:58:43PM +0200, Ján Tomko wrote: > On a Wednesday in 2020, Andrea Bolognani wrote: > > Indent all code snippets by the same number of spaces, and don't > > embed the :: marker in the line preceding a code block. > > But why? It's so ugly. That aligns with the style we've used in all other rst docs we've done so far. Ideally we wouldn't use a bare "::" anyway - we really ought to be using ".. code-block:: $LANGUAGE" to instruct the renderer how to highlight the code snippets. Our current website generator doesn't use this, but hopefully we will in future Regards, Daniel -- |: https://berrange.com -o- https://www.flickr.com/photos/dberrange :| |: https://libvirt.org -o- https://fstop138.berrange.com :| |: https://entangle-photo.org -o- https://www.instagram.com/dberrange :|
