[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