Open Stack

I opened bug https://bugs.launchpad.net/openstack-manuals/+bug/1335423


Diane
----------------------------------------------
Diane Fleming
Software Developer II - US
diane.fleming at rackspace.com
Cell  512.323.6799
Office 512.874.1260
Skype drfleming0227
Google-plus diane.fleming at gmail.com

From: Anne Gentle <anne at openstack.org<mailto:anne at openstack.org>>
Date: Saturday, June 28, 2014 7:44 AM
To: Diane Fleming <diane.fleming at rackspace.com<mailto:diane.fleming at rackspace.com>>
Cc: Roger Luethi <rl at patchworkscience.org<mailto:rl at patchworkscience.org>>, "openstack-docs at lists.openstack.org<mailto:openstack-docs at lists.openstack.org>" <openstack-docs at lists.openstack.org<mailto:openstack-docs at lists.openstack.org>>
Subject: Re: [Openstack-docs] weighted vs. weighed

Agreed... log a bug and correct the use to the statistical weighted.

I'm giggling a bit at the image of heavy cells and hosts.


On Sat, Jun 28, 2014 at 7:00 AM, Diane Fleming <diane.fleming at rackspace.com<mailto:diane.fleming at rackspace.com>> wrote:
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<mailto: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<mailto:Openstack-docs at lists.openstack.org>
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs

_______________________________________________
Openstack-docs mailing list
Openstack-docs at lists.openstack.org<mailto:Openstack-docs at lists.openstack.org>
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20140628/f2591fda/attachment.html>