Thanks for starting this thread, comments below.<br><div style="margin: 2em 0pt;" name="sig_d4a6b6619e"><div style="padding: 5px; font-size: 11px; color: rgb(102, 102, 102); font-family: sans-serif;">
<strong>Anne Gentle</strong>
 <br>
<a href="mailto:anne@openstack.org" target="_blank">anne@openstack.org</a><br>
<div style="font-size: 10px;">
<a href="http://justwriteclick.com/" target="_blank">my blog</a> |
<a href="http://xmlpress.net/publications/conversation-community/" target="_blank">my book</a> |
<a href="http://www.linkedin.com/in/annegentle" target="_blank"><span>LinkedIn</span></a> | <a href="http://del.icio.us/annegentle" target="_blank">Delicious</a> |
 <a href="http://twitter.com/annegentle" target="_blank">Twitter</a>

</div></div></div><div class="gmail_quote">On Tue, Feb 22, 2011 at 3:11 AM, Thierry Carrez <span dir="ltr"><<a href="mailto:thierry@openstack.org" target="_blank">thierry@openstack.org</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;"><div>Christian Berendt wrote:<br>
<br>
> a) we should create a useful documentation including all flags<br>
<br></div></blockquote><div><br>Agreed. I have taken a few steps in this direction. <br><br>On the Docs site, this page contains all the flags, their defaults, and descriptions.<br><br><a href="http://docs.openstack.org/openstack-compute/admin/content/ch05s08.html" target="_blank">http://docs.openstack.org/openstack-compute/admin/content/ch05s08.html</a><br>


<br>I need specific questions answered in order to make this more accurate. <br>1. cc_host used to be a flag. If it's not listed in the --help output any more, is it just ignored and doesn't set anything? My guess is that it has been replaced with all the --ec2_ flags that indicate where nova-api is installed.<br>


2. It appears that --fixed_range and --network_size are not listed in the --help listing either, but had been used previously. How are these network settings handled now?<br><br>Also, we need to organize these in logical groups and then write "how to" sections for configuring particular scenarios with the flags. For example, the flags you need to set for volume management and the flags you need to set to use Glance for image storage. <br>

<br>Thierry (and others who are interested), please see what logical groupings make sense to you and send them to me. I started to do this in Table 5.2 on the Docs site (on the page linked above).<br>
 </div><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;"><div>
</div>That's been identified as a necessary area of improvement for doc. I<br>
plan to work on the raw info (organize them in themes and document their<br>
use) and Anne should help me get it into the openstack manual.<br>
<br>
It's a bit hard to keep up to date though. Ideally we would autogenerate<br>
it from comments in code...<br>
<div><br></div></blockquote><div><br>Agreed here too. I also have a merge request to put the list of flags into the RST doc site - if one more Nova core group member approves and merges this branch there will be a list in the RST docs, but it would be better to include that in the autodoc to keep it updated rather than a manual method. Here's the merge request:<br>


<br><a href="https://code.launchpad.net/%7Eannegentle/nova/docslice" target="_blank">https://code.launchpad.net/~annegentle/nova/docslice</a><br><br>Thanks for the help. <br><br>Anne<br> </div><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">


<div>
> b) we should introduce a naming convention for new flags and we should<br>
> rename existing flags<br>
><br>
> example:<br>
><br>
> all flags related to default values are starting with "default_", all<br>
> flags related to a path are starting with "path_".<br>
><br>
> Looks like most of the flags have good names at the moment, but I think<br>
> we should write it down in the wiki or the developer documentation to<br>
> reduce the possibility of bad names in the future.<br>
<br>
</div>That's definitely something we should do, either in the RST developer<br>
doc or as a CodingStandards subpage in the wiki. Christian: do you take<br>
the lead on that ?<br>
<div><br>
> c) if it's possible we should collect all flags in one file<br>
><br>
> At the moment the flags are defined in the files where they are used. I<br>
> think it would be nice to have on file, for example nova/flags.py,<br>
> including all flags used all over the code.<br>
<br>
</div>I think there is a rationale for defining some flags locally. If not,<br>
I'd support placing them all in flags.py with a comment about where they<br>
apply, which could serve as a basis for an autogenerated doc.<br>
<br></blockquote><div><br>+1<br>
</div></div>