<div dir="ltr">Andreas,<div><br></div><div>I receive quite a few complaints that our automatic documentation merely copies help strings in the code instead of providing additional information. We could ask developers to provide additional information in the help strings, but it would cause large example configuration files or excessive CLI output. So, I made a suggestion at the summit (with Doug) to split help strings into short and long versions. The short version would appear in example configuration files or CLI output and the long version would appear in our automatic documentation.<br></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Tue, May 10, 2016 at 1:33 AM, Andreas Jaeger <span dir="ltr"><<a href="mailto:aj@suse.com" target="_blank">aj@suse.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">At the OpenStack summit we discussed whether and how to use oslo.config<br>
directly to generate configuration options for the Configuration Reference.<br>
<br>
One idea was to move the flagmappings to the project repositories and<br>
let them maintain it.<br>
<br>
Is anybody interested in working with Doug on this? First Doug needs to<br>
understand our requirement - so writing those up would be the first part.<br>
<span class="HOEnZb"><font color="#888888"><br>
Andreas<br>
--<br>
 Andreas Jaeger aj@{<a href="http://suse.com" rel="noreferrer" target="_blank">suse.com</a>,<a href="http://opensuse.org" rel="noreferrer" target="_blank">opensuse.org</a>} Twitter: jaegerandi<br>
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
   GF: Felix Imendörffer, Jane Smithard, Graham Norton,<br>
       HRB 21284 (AG Nürnberg)<br>
    GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126<br>
<br>
<br>
_______________________________________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</font></span></blockquote></div><br></div>