Open Stack

This happened to me a couple times.  I think if you check the files called before keystone-install.rst,you'll find someplace where the order of marking the section headers is different.  If you fix that,the keystone-install file will be fine.
Apparently there are different conventions for the order of the heading marks in a file and some of thedocs show that it should be ----- then ~~~~.   Sometimes the build messages bust you for having theheadings out of line, but sometimes RST apparently just adopts the new conventions.  I'm not enoughof an RST expert to explain this thing.
I confess that, the first time this happened to me, I shrugged and said "whatever" and used the order forthe headings that worked.  But this then caused problems in the subsequent files...
meg

 
      From: Andreas Jaeger <aj at suse.com>
 To: "openstack-docs at lists.openstack.org" <Openstack-docs at lists.openstack.org> 
 Sent: Thursday, September 24, 2015 10:57 PM
 Subject: Re: [OpenStack-docs] Help with RST needed
   
On 09/25/2015 07:28 AM, Andreas Jaeger wrote:
> Matt has a problem with using only in
> https://review.openstack.org/227609, is there anybody that can help why
> this is rendered wrong, please?
>
> His plea for help is:
> "In the keystone-install.rst file, I put some test section and
> subsection headings to show a conditional rendering problem. If the
> headings use the conventions order of "~~~" and "---", nothing renders.
> If they use the opposite order of "---" and "~~~", the content renders.
> Can you help?"
>
> I looked but I'm puzzled right now,

Please follow up to Matt's original email, I send this one out without 
going through the list, sorry for the noise,



Andreas
-- 
  Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
    GF: Felix Imendörffer, Jane Smithard, Graham Norton,
        HRB 21284 (AG Nürnberg)
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126


_______________________________________________
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/20150925/dd6bf353/attachment-0001.html>