Open Stack

Never ask a woman how much she weights... 


I agree - the terms should be - 
Weighting
Weighted

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." 




Sent from my iPhone

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