Open Stack

----- Original Message -----
> From: "Andreas Jaeger" <aj at suse.com>
> To: openstack-docs at lists.openstack.org
> Sent: Wednesday, August 14, 2013 2:05:29 PM
> Subject: Re: [Openstack-docs] programlisting language="bash" or language="INI" for config files?
> 
> On 08/14/2013 07:13 PM, Steve Gordon wrote:
> > ----- Original Message -----
> >> From: "Andreas Jaeger" <aj at suse.com>
> >> To: openstack-docs at lists.openstack.org
> >> Sent: Wednesday, August 14, 2013 12:35:25 PM
> >> Subject: [Openstack-docs] programlisting language="bash" or language="INI"
> >>         for config files?
> >>
> >> Stephen Gordon asked in reviewing https://review.openstack.org/41861:
> >>
> >> "Line 146:                                 <programlisting
> >> language="bash">[DEFAULT]
> >> Is bash actually the correct directive for these, I'm not super familiar
> >> with clouddocs-maven's highlight functionality but other tools I have
> >> worked with have one specifically for the INI file format?"
> >>
> >> Looking at the wiki, I do not see INI mentioned - and don't see it used
> >> anywhere. So, is there an INI option we should use or should we continue
> >> using "bash"?
> 
> 
> Diane answered it with this link as part of the review, so "bash" is fine:
> https://github.com/rackerlabs/clouddocs-maven-plugin/#new-features-and-changes-1
> 
> Thanks Diane!

The other option would be to not provide the language attribute at all, which is semantically correct and what I see in most examples of INI content I can find in openstack-manuals. If there's an expectation that for INI files they will always be marked up as Bash then I think it should be added to the Conventions and applied uniformly:

    https://wiki.openstack.org/wiki/Documentation/Conventions#Code_or_data_.28block.29

Thanks,

Steve