fuel-dev team mailing list archive

[Dmitry Ilyin <dilyin@xxxxxxxxxxxx>]

Hi, Meg

I have built the second revision of your updates without an error.

It's great that we are going to correct our fuel-docs repo, there are a lot
of minor issues, old garbage and other stuff that should be fixed.
If you have any problems with rst or Sphinx or just need an advice you can
always ask me, I'll try to help you.
And I can also participate in the doc cleanup process.


2014-04-03 10:45 GMT+04:00 Mike Scherbakov <mscherbakov@xxxxxxxxxxxx>:

> Sorry Meg,
> I can't really help as I'm overloaded these days.
>
> fuel-dev, any volunteer to help Meg with Sphinx?
>
> Thanks!
>
>
> On Tue, Apr 1, 2014 at 11:37 AM, Meg McRoberts <mmcroberts@xxxxxxxxxxxx>wrote:
>
>> Thanks, Mike.  Yes, this is one of the documents I found.  My problem is
>> that I don't know what or where the
>> container directive is.  I read  this:
>> http://docutils.sourceforge.net/docs/ref/rst/directives.html -- it looks
>> like the
>> container directive is going to contain the "container" string -- I did a
>> grep -r on the fuel-docs repo and get no
>> hits for "container".
>>
>> Any suggestions about what I should be looking for?  This was building
>> fine before I split the files...
>>  meg
>>
>>
>> On Mon, Mar 31, 2014 at 11:47 PM, Mike Scherbakov <
>> mscherbakov@xxxxxxxxxxxx> wrote:
>>
>>> Doesn't this help:
>>> http://comments.gmane.org/gmane.text.docutils.user/5827 ?
>>>
>>>
>>> On Tue, Apr 1, 2014 at 8:09 AM, Meg McRoberts <mmcroberts@xxxxxxxxxxxx>wrote:
>>>
>>>> Hi, Mike,
>>>> I have a doc build problem that I can't figure out -- could you help or
>>>> forward this to
>>>> someone else who can help.
>>>>
>>>> As a first step in the doc reorganization (blueprints coming soon),
>>>> Dmitry wants me to
>>>> break up the existing doc source into modular files -- only one header
>>>> section per file.
>>>> Also making the source tree deeper, with more sub-directories.  I am
>>>> doing this phase
>>>> without modifying or moving any of the information.
>>>>
>>>> The Install Guide is the last one I did and I am now getting the
>>>> following build error:
>>>>
>>>> Warning, treated as error:
>>>> pages/install-guide/0070-networks/0100-understand-config-network.rst:11:
>>>> SEVERE: Unexpected section title.
>>>>
>>>>     Understanding and Configuring the Network
>>>>     =========================================
>>>>
>>>>     make: *** [html] Error 1
>>>>     megm@megm-ThinkPad-W530:~/fuel-docs$
>>>>
>>>> This happens locally and with Jenkins.
>>>>
>>>> I googled and found information that this indicates that I have a
>>>> section header inside a
>>>> container directive but I can't find the "container" string anywhere in
>>>> these docs.  I've tried
>>>> all sorts of things to get around it -- if I delete the "========="
>>>> line under this header, I get
>>>> the same message for the next heading that comes up.
>>>>
>>>> Is there something else that masquerades as a container directory?
>>>>  Anything else I should
>>>> look for.
>>>>
>>>> I committed the files despite the build error so you could see them:
>>>> https://review.openstack.org/#/c/84334/
>>>>
>>>> I'll be online past midnight
>>>> my time if you want to Skype or something.
>>>>
>>>> Thanks much!
>>>> meg
>>>>
>>>
>>>
>>>
>>> --
>>> Mike Scherbakov
>>> #mihgen
>>>
>>
>>
>
>
> --
> Mike Scherbakov
> #mihgen
>
> --
> Mailing list: https://launchpad.net/~fuel-dev
> Post to     : fuel-dev@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~fuel-dev
> More help   : https://help.launchpad.net/ListHelp
>
>