<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
</head>
<body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">
<br class="">
<div>
<blockquote type="cite" class="">
<div class="">On Aug 29, 2016, at 8:19 AM, Dean Troyer <<a href="mailto:dtroyer@gmail.com" class="">dtroyer@gmail.com</a>> wrote:</div>
<br class="Apple-interchange-newline">
<div class="">
<div dir="ltr" class="">
<div class="gmail_extra">
<div class="gmail_quote">On Mon, Aug 29, 2016 at 9:41 AM, Loo, Ruby <span dir="ltr" class="">
<<a href="mailto:ruby.loo@intel.com" target="_blank" class="">ruby.loo@intel.com</a>></span> wrote:<br class="">
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
I did this because 'passthrough' is more English than 'passthru' and I thought that was the 'way to go' in osc. But some folks wanted it to be 'passthru' because in ironic, we've been calling them 'passthru' since day 2.
</blockquote>
<div class=""><br class="">
</div>
<div class="">Our default rule is to use proper spellings and not abbreviations[0]. The exceptions we have made are due to either a) significant existing practice in the industry (outside OpenStack, mostly in the network area so far); and b) when the user
experience is clearly improved.</div>
</div>
</div>
</div>
</div>
</blockquote>
<div><br class="">
</div>
To be clear; thru is a valid english word, in just about every dictionary I've checked. In fact, some evidence shows it predates "through" as a word. I agree with other folks who have posted on the mailing list that keeping "passthru" is going to be more clear
to operators of ironic than changing it to "passthrough" in this single context.</div>
<div><br class="">
</div>
<div>Thanks,</div>
<div>Jay Faulkner</div>
<div>OSIC</div>
<div><br class="">
</div>
<div>
<blockquote type="cite" class="">
<div class="">
<div dir="ltr" class="">
<div class="gmail_extra">
<div class="gmail_quote">
<div class=""><br class="">
</div>
<div class="">You might notice that calling out prior OpenStack usage is absent from that list. One of the tenets of OSC from the start is to look first at user experience and identifying a _single_ set of terminology. An existing practice can fall under
(b) when it is compelling overall, and is an easier case to make when there is no competing OSC usage, or other OSC usage matches.</div>
<div class=""><br class="">
</div>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Unfortunately, I wasn't able to make everyone happy because someone else thinks that we shouldn't be providing two different openstack commands that provide the same functionality. (They're fine with either one, just not both.)<br class="">
</blockquote>
<div class=""><br class="">
</div>
<div class="">I agree with not aliasing commands out of the box. We'll do that for deprecations, and are looking at a generalize alias method for other reasons, but on initial implementation I would prefer to not do this.</div>
<div class=""> </div>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
What do the rest of the folks think? Some guidance from the OpenStackClient folks would be greatly appreciated.<br class="">
</blockquote>
<div class=""><br class="">
</div>
<div class="">I would suggest you pick the one that lines up with usage outside OpenStack, in the sorts of ways that our users would be familiar with[1]. In this case, a grep of help output of even 'passthr' will find the match.</div>
<div class=""><br class="">
</div>
<div class="">Hopefully this all makes enough sense that we can add it as a guideline to the OSC docs. Feedback welcome.</div>
<div class=""><br class="">
</div>
<div class="">Thanks</div>
<div class="">dt</div>
<div class=""><br class="">
</div>
<div class="">[0] Where 'proper' is usually North American English, for whatever definition of that we have. This is totally due to me not thinking far enough ahead 4 years ago...</div>
<div class=""><br class="">
</div>
<div class="">[1] Cases like "all other clouds use this term" or "it is the common way to refer to this resource in the networking field" have been used in the past.</div>
<div class=""><br class="">
</div>
</div>
<div class="gmail_signature" data-smartmail="gmail_signature">-- <br class="">
Dean Troyer<br class="">
<a href="mailto:dtroyer@gmail.com" target="_blank" class="">dtroyer@gmail.com</a><br class="">
</div>
</div>
</div>
__________________________________________________________________________<br class="">
OpenStack Development Mailing List (not for usage questions)<br class="">
Unsubscribe: <a href="mailto:OpenStack-dev-request@lists.openstack.org" class="">
OpenStack-dev-request@lists.openstack.org</a>?subject:unsubscribe<br class="">
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" class="">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br class="">
</div>
</blockquote>
</div>
<br class="">
</body>
</html>