<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
<body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; color: rgb(0, 0, 0); font-size: 14px; font-family: Calibri, sans-serif;">
<div>What is the point of the guideline if we're not able to influence some of the biggest projects out there, that would keep growing with what they have.. </div>
<div><br>
</div>
<div>Maybe we should add a note in each of those guidelines saying some examples exist where SERVICE_TYPE has been replaced by PROJECT_NAME for these headers; however, this "anomaly" is only where projects have/support multiple controllers, under different
 SERVICE_TYPEs. It should be explicit that guidelines recommend SERVICE_TYPE (as Dean stated) and do not recommend the PROJECT_NAME; and that the main purpose of inclusion of these names at all is to distinguish the headers when they are being recorded for
 some support purposes, etc; amongst all the OpenStack REST API calls.</div>
<div><br>
</div>
<div>--</div>
<div>Goutham</div>
<div><br>
</div>
<div><br>
</div>
<div><br>
</div>
<span id="OLK_SRC_BODY_SECTION">
<div style="font-family:Calibri; font-size:12pt; text-align:left; color:black; BORDER-BOTTOM: medium none; BORDER-LEFT: medium none; PADDING-BOTTOM: 0in; PADDING-LEFT: 0in; PADDING-RIGHT: 0in; BORDER-TOP: #b5c4df 1pt solid; BORDER-RIGHT: medium none; PADDING-TOP: 3pt">
<span style="font-weight:bold">From: </span>Dean Troyer <<a href="mailto:dtroyer@gmail.com">dtroyer@gmail.com</a>><br>
<span style="font-weight:bold">Reply-To: </span>"OpenStack Development Mailing List (not for usage questions)" <<a href="mailto:openstack-dev@lists.openstack.org">openstack-dev@lists.openstack.org</a>><br>
<span style="font-weight:bold">Date: </span>Wednesday, January 27, 2016 at 3:31 PM<br>
<span style="font-weight:bold">To: </span>"OpenStack Development Mailing List (not for usage questions)" <<a href="mailto:openstack-dev@lists.openstack.org">openstack-dev@lists.openstack.org</a>><br>
<span style="font-weight:bold">Subject: </span>Re: [openstack-dev] [api] service type vs. project name for use in headers<br>
</div>
<div><br>
</div>
<div>
<div>
<div dir="ltr">
<div class="gmail_extra">
<div class="gmail_quote">On Wed, Jan 27, 2016 at 1:47 PM, michael mccune <span dir="ltr">
<<a href="mailto:msm@redhat.com" target="_blank">msm@redhat.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
i am not convinced that we would ever need to have a standard on how these names are chosen for the header values, or if we would even need to have header names that could be deduced. for me, it would be much better for the projects use an identifier that makes
 sense to them, *and* for each project to have good api documentation.<br>
</blockquote>
<div><br>
</div>
<div>I think we would be better served in selecting these things thinking about the API consumers first.  We already have  enough for them to wade through, the API-WG is making great gains in herding those particular cats, I would hate to see giving back some
 of that here.</div>
<div> </div>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
so, instead of using examples where we have header names like "OpenStack-Some-[SERVICE_TYPE]-Header", maybe we should suggest "OpenStack-Some-[SERVICE_TYPE or PROJECT_NAME]-Header" as our guideline.<br>
</blockquote>
<div><br>
</div>
<div>I think the listed reviews have it right, only referencing service type.  We have attempted to reduce the visible surface area of project names in a LOT of areas, I do not think this is one that needs to be an exception to that.</div>
<div><br>
</div>
<div>Projects will do what they are going to do, sometimes in spite of guidelines.  This does not mean that the guidelines need to bend to match that practice when it is at odds with larger concerns.</div>
<div><br>
</div>
<div>In this case, the use of service type as the primary identifier for endpoints and API services is well established, and is how the service catalog has and will always work.</div>
<div><br>
</div>
<div>dt</div>
<div><br>
</div>
</div>
-- <br>
<div class="gmail_signature"><br>
Dean Troyer<br>
<a href="mailto:dtroyer@gmail.com" target="_blank">dtroyer@gmail.com</a><br>
</div>
</div>
</div>
</div>
</div>
</span>
</body>
</html>