[OpenStack-docs] Process to add a table in openstack-manuals
Gauvain Pocentek
gauvain.pocentek at objectif-libre.com
Wed Aug 31 13:56:21 UTC 2016
Le 2016-08-31 13:19, Deshpande, Vinita a écrit :
> Thanks Gauvain, I am able to now generate the cinder-coprhd.rst file
> in my local setup. Do, I need to submit this generated file somewhere?
> Also, do I need to remove the line ' .. include::
> ../../tables/cinder-coprhd.rst' from my documentation
> file(coprhd-driver.rst) ? If this line is present, I am
> Getting the error - 'No such file : cinder-coprhd.rst'.
You just need to add your file to your review:
https://review.openstack.org/#/c/352822/ , it should be enough.
Gauvain
>
>
> -----Original Message-----
> From: Gauvain Pocentek [mailto:gauvain.pocentek at objectif-libre.com]
> Sent: Wednesday, August 31, 2016 2:28 PM
> To: Deshpande, Vinita
> Cc: openstack-docs at lists.openstack.org; Hallur, Parashuram; yang,
> xing; Kulkarni, Mallari
> Subject: Re: [OpenStack-docs] Process to add a table in
> openstack-manuals
>
> Hello Vinita,
>
> Le 2016-08-31 10:12, Deshpande, Vinita a écrit :
>> Hello everybody,
>>
>> I have raised a pull request in openstack for our CoprHD volume
>> driver
>> documentation in openstack-manuals project. Pull request :
>> https://review.openstack.org/#/c/352822/ [1]
>>
>> My driver doc uses a table (cinder-coprhd.rst), which is supposed to
>> be auto-generated as per a comment given on the pull request. As I am
>> completely new to this, can someone please guide me on how to add the
>> table in "doc/config-reference/source/tables" ?
>>
>> I have already added ".. include:: ../../tables/cinder-coprhd.rst" in
>> my documentation.
>
> The tools that can generate this file is in the openstack-doc-tools
> git
> repo:
> https://github.com/openstack/openstack-doc-tools/tree/master/autogenerate_config_docs
>
> The README describes how you can setup your environment, then you
> would have to run:
>
> $ ./autohelp-wrapper update cinder
> $ vim
> sources/openstack-manuals/tools/autogenerate-config-flagmappings/cinder.*
> $ ./autohelp-wrapper rst cinder
>
> In the cinder.flagmappings file you have to add a 'coprhd' next to
> the options you driver brings, and you can add a 'coprhd' entry in the
> cinder.headers file to get a nice title for the table.
>
> HTH,
> Gauvain
Gauvain Pocentek
Objectif Libre - Infrastructure et Formations Linux
http://www.objectif-libre.com
phone: +33 972 54 98 01 / +33 611 60 84 25
More information about the OpenStack-docs
mailing list