Open Stack

I'm sure you're right for those examples, but ensuring that the user knows that it is a variable covers all bases (even those with strange and wonderful configurations), and caps really do that. Not to mention that switching between caps and no caps gets rid of that standardization feel, which was the original motivator? 

Just 2 ¢ 
Summer 

----- Original Message -----

> From: "Tom Fifield" <tom at openstack.org>
> To: "Summer Long" <slong at redhat.com>
> Cc: openstack-docs at lists.openstack.org
> Sent: Tuesday, April 22, 2014 5:36:01 PM
> Subject: Re: [Openstack-docs] <replaceable>VALUE</replaceable> conventions?

> On 22/04/14 15:30, Summer Long wrote:
> > I'm +1 on the caps as well to make it obvious.
> >
> > Even more so in those cases where it functions without changing it. It
> > might work, but not as they expect because they didn't think about it, and
> > then they troubleshoot for days....

> In the examples I've provided (one from the install guide, and one from
> the config reference), I don't believe this would be the case.

> Do you have some examples where this could happen so we can help make a
> distinction?

> Regards,

> Tom
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20140422/fbcde27a/attachment-0001.html>