<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Wed, Apr 29, 2015 at 8:00 PM, Jay Pipes <span dir="ltr"><<a href="mailto:jaypipes@gmail.com" target="_blank">jaypipes@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div class=""><div class="h5">On 04/29/2015 03:41 PM, Ed Leafe wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
On Apr 29, 2015, at 2:30 PM, Matt Riedemann<br>
<<a href="mailto:mriedem@linux.vnet.ibm.com" target="_blank">mriedem@linux.vnet.ibm.com</a>> wrote:<br>
<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
I'd prefer to see the scheduler filter docs be maintained in the<br>
nova devref where they are close to the source, versioned, and<br>
reviewed by the nova team when there are scheduler filter changes<br>
or new filters added.<br>
</blockquote>
<br>
For now, I think this is best. When and if the scheduler is a<br>
separate entity, it will need its own docs; nova will still need to<br>
document *its* filters, but not *how to* filter.<br>
</blockquote>
<br></div></div>
So, the config-ref docs are auto-generated continually via automation scripts from the help text of options. And, IMO, this is A Good Thing.<br>
<br>
In this case, the end user of this information is the cloud admin -- the person who creates flavors and tags compute nodes with capability extra specs. The target audience for this information is not really the Nova developer.<br>
<br>
Now, if there are sections of the devref that need to inform the *developer* about some weird intricacies of the scheduler filters (and frankly, this is kind of one of them), then I think it's OK to have slightly duplicate information. It depends on the target audience. In this particular case, I think it's fine to duplicate a little.<br>
<br></blockquote><div><br></div><div>Right, to me this is the right approach, thanks Jay. I say this because here are the stats for each page, showing where your audience is.</div><div><br></div><div><span style="color:rgb(0,0,0);font-family:Arial,Helvetica,Geneva,sans-serif;font-size:13px;font-weight:bold;text-align:right;white-space:nowrap;background-color:rgb(250,250,250)">10,473 page views in six months:</span><span style="font-size:12.8000001907349px">[1] </span><a href="http://docs.openstack.org/juno/config-reference/content/section_compute-scheduler.html#aggregate-instanceextraspecsfilter" target="_blank" style="font-size:12.8000001907349px">http://docs.openstack.org/juno/config-reference/content/section_compute-<span class="">scheduler</span>.html#aggregate-instanceextraspecsfilter</a><br></div><div><span style="color:rgb(0,0,0);font-family:Arial,Helvetica,Geneva,sans-serif;font-size:13px;font-weight:bold;text-align:right;white-space:nowrap;background-color:rgb(250,250,250)">5,143 page views in same six months: </span><br></div><span style="font-size:12.8000001907349px">[2] </span><a href="http://docs.openstack.org/developer/nova/devref/filter_scheduler.html#filtering" target="_blank" style="font-size:12.8000001907349px">http://docs.openstack.org/developer/<span class="">nova</span>/devref/filter_scheduler.html#filtering</a><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
Best,<br>
-jay<div class=""><div class="h5"><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" target="_blank">OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature">Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a></div>
</div></div>