<div dir="ltr">I think we can help. Do you want us to submit patches for config option descriptions that benefit from rewording? Also, you might want to post to the -docs list.</div><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Jul 18, 2016 at 6:29 AM, Markus Zoeller <span dir="ltr"><<a href="mailto:mzoeller@linux.vnet.ibm.com" target="_blank">mzoeller@linux.vnet.ibm.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">I'd like to ask the docs team if they see the possibility to have<br>
reviews of the merged config options help texts Nova has updated in the<br>
last months.<br>
<br>
Background: In Mitaka and Newton, Nova put a lot of effort in providing<br>
valuable help texts for their config options. They are written from<br>
developers for operators. My assumption is, that technical writers like<br>
the docs team look at them differently. As these help texts get<br>
extracted from the code and will be used directly in the "configuration<br>
reference" manual, the text "by-passed" the writing expertise of the<br>
docs team.<br>
<br>
Be aware, that this is still an ongoing effort in Nova (see [1],<br>
especially "needs:fix_opt_description").<br>
<br>
References:<br>
[1] <a href="http://45.55.105.55:8082/config-options.html" rel="noreferrer" target="_blank">http://45.55.105.55:8082/config-options.html</a><br>
<span class="HOEnZb"><font color="#888888"><br>
--<br>
Regards, Markus Zoeller (markus_z)<br>
<br>
<br>
__________________________________________________________________________<br>
OpenStack Development Mailing List (not for usage questions)<br>
Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</font></span></blockquote></div><br></div>