Good questions... I admit that I tend to use the plain :: by default. If that doesn't format correctly,then I usually flip to code-block. I have some notes about information to add to https://wiki.openstack.org/wiki/Documentation/Markup_conventions#Code_or_data_.28block_and_inline.29so, once we agree about this, I'll write it up. From: Christian Berendt <christian at berendt.io> To: "openstack-docs at lists.openstack.org" <Openstack-docs at lists.openstack.org> Sent: Monday, July 27, 2015 2:28 PM Subject: [OpenStack-docs] [RST] difference between the code and the code-block directive Sometimes we use .. code:: and sometimes we use .. code-block::. What is the difference? Does it makes sense to only use .. code-block:: and to remove the usage of .. code::? Christian. -- Christian Berendt Cloud Solution Architect Mail: berendt at b1-systems.de B1 Systems GmbH Osterfeldstraße 7 / 85088 Vohburg / http://www.b1-systems.de GF: Ralph Dehner / Unternehmenssitz: Vohburg / AG: Ingolstadt,HRB 3537 _______________________________________________ OpenStack-docs mailing list OpenStack-docs at lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20150727/7daee64d/attachment.html>