Open Stack

On 04/17/2015 02:07 PM, Bernd Bausch wrote:
> Thanks! Panic mode off.
>
> BUT:
>
> The SHA looks good.
> The source link not so good.
>
> Correct link: blabla/tree/doc/user-guides/source/name-of-guide/mumble.rst.

Not name-of-guide but name of directory! Have a look at the current
directory structure.

> Link in bug:  blabla/tree/doc/user-guides/source/mumble.rst

>
> Unfortunately openstackdocstheme expects conf.py to be in the same directory as the rst files. That was so in the test environment, but is not so in production.


correct, conf.py is one directory up.

> This means either the build structure needs to change, so that each separate book has its own conf.py, or the code in openstackdocstheme must be made to work without that assumption. Personally, I prefer the former approach :) though the latter is more robust and future-proof. The question is how can we communicate the name of the book to openstackdocstheme.

Currently each separate book has its own conf.py.

>
> Both approaches require knowledge of the build process, which I don't have for the moment.

Just run "tox -e docs" in openstack-manuals to get the books build...

And feel free to ask me anything - if you prefer in German and
off-list ;)

Andreas

>
> Bernd.
>
> -----Original Message-----
> From: Andreas Jaeger [mailto:aj at suse.com]
> Sent: Friday, April 17, 2015 8:31 PM
> To: Bernd Bausch; 'openstack-docs at lists.openstack.org'
> Subject: Re: [OpenStack-docs] RST Based User Guides are published!
>
> On 04/17/2015 11:33 AM, Andreas Jaeger wrote:
>> Bernd, I expect that https://review.openstack.org/174780 will fix some
>> issues.
>
> Looks good now:
>
> -----------------------------------
> Release: 1.0.0 on 2015-04-17 11:22
> SHA: a530e381d1d54538c0de114e388b2ddd280d266f
> Source:
> http://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/user-guides/source/cli_discover_version_number_for_a_client.rst
>


-- 
  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, Jennifer Guild, Dilip Upmanyu,
        Graham Norton, HRB 21284 (AG Nürnberg)
     GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126