[Openstack-docs] Consistency for "titles" in lists?
Andreas Jaeger
aj at suse.com
Fri May 2 07:03:05 UTC 2014
I've seen various forms used during reviews in lists with many items:
1)
<listitem><para><guilabel>Boot from image</guilabel>—If you choose
...
2) And also:
<listitem>
<para><code>scheduler_filter_classes</code> - Specifies the list of filter
And then the usage of
3) <formalpara> with <title>,
4) ":" instead of —,
5) &ndash or "-"
I've seen recently some patches using the first variant but there's a
lot of variations. Do we want to have a consistent style for new
changes? And which one?
This was triggered by reviewing https://review.openstack.org/91736,
https://review.openstack.org/90625 and then editing
config-reference/compute/section_compute-cells.xml
Andreas
--
Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126
More information about the Openstack-docs
mailing list