<div dir="ltr">Agreed... log a bug and correct the use to the statistical weighted.<div><br></div><div>I'm giggling a bit at the image of heavy cells and hosts.</div></div><div class="gmail_extra"><br><br><div class="gmail_quote">

On Sat, Jun 28, 2014 at 7:00 AM, Diane Fleming <span dir="ltr"><<a href="mailto:diane.fleming@rackspace.com" target="_blank">diane.fleming@rackspace.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

Never ask a woman how much she weights...<br>
<br>
<br>
I agree - the terms should be -<br>
Weighting<br>
Weighted<br>
<br>
Adding to the confusion is the use of passive voice in the books - like "devices are weighted by size" - that should be reworded to something like "the xxx weights devices by size."<br>
<br>
<br>
<br>
<br>
Sent from my iPhone<br>
<div class="HOEnZb"><div class="h5"><br>
> On Jun 28, 2014, at 12:40 AM, "Roger Luethi" <<a href="mailto:rl@patchworkscience.org">rl@patchworkscience.org</a>> wrote:<br>
><br>
> A recent review made me wonder about how we are using weight in the<br>
> documentation. When OpenStack talks about weight, it doesn't mean mass<br>
> but a statistical property.<br>
><br>
> Such properties, to the best of my knowledge (and a little web search),<br>
> are used when "weighting" the members of a class, when producing<br>
> a weighted average or a weighted index. But some of the OpenStack<br>
> documentation talks about "weighing".<br>
><br>
> Here are some samples from nova docs:<br>
><br>
> # During its work Filter Scheduler firstly makes dictionary of<br>
> # unfiltered hosts, then filters them using filter properties and<br>
> # finally chooses hosts for the requested number of instances (each<br>
> # time it chooses the most weighed host and appends it to the list of<br>
> # selected hosts).<br>
><br>
> # If we speak about `filtering` and `weighting`, their work is quite<br>
> # flexible in the Filter Scheduler.<br>
><br>
> In the openstack-manuals repo, I found examples that seem correct to me<br>
> ("Devices are weighted by size.") and others that are rather dubious<br>
> or clearly incorrect ("How the metrics are going to be weighed.",<br>
> "Hosts and cells are weighed based on the following options [...]").<br>
><br>
> Unfortunately, the API docs are sometimes rather unhelpful, containing<br>
> explanations like this gem:<br>
><br>
> #     def weight_multiplier(self):<br>
> #        """How weighted this weigher should be.<br>
><br>
> Anyone else want to weigh in on this matter?<br>
><br>
> Roger<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" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><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" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</div></div></blockquote></div><br></div>