<div dir="ltr"><div>Thanks for the suggestions, I'll give that patch another crack.<br><br></div>-Angus<br></div><div class="gmail_extra"><br><div class="gmail_quote">On Sat, Sep 20, 2014 at 10:11 AM, Qiming Teng <span dir="ltr"><<a href="mailto:tengqim@linux.vnet.ibm.com" target="_blank">tengqim@linux.vnet.ibm.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="HOEnZb"><div class="h5">On Fri, Sep 19, 2014 at 11:20:43AM +0200, Thomas Spatzier wrote:<br>
> > From: Mike Spreitzer <<a href="mailto:mspreitz@us.ibm.com">mspreitz@us.ibm.com</a>><br>
> > To: "OpenStack Development Mailing List \(not for usage questions\)"<br>
> > <<a href="mailto:openstack-dev@lists.openstack.org">openstack-dev@lists.openstack.org</a>><br>
> > Date: 19/09/2014 07:15<br>
> > Subject: Re: [openstack-dev] [Heat] naming of provider template for docs<br>
> ><br>
> > Angus Salkeld <<a href="mailto:asalkeld@mirantis.com">asalkeld@mirantis.com</a>> wrote on 09/18/2014 09:33:56 PM:<br>
> ><br>
> > > Hi<br>
> ><br>
> > > I am trying to add some docs to openstack-manuals hot_guide about<br>
> > > using provider templates : <a href="https://review.openstack.org/#/c/121741/" target="_blank">https://review.openstack.org/#/c/121741/</a><br>
> ><br>
> > > Mike has suggested we use a different term, he thinks "provider" is<br>
> > > confusing.<br>
> > > I agree that at the minimum, it is not very descriptive.<br>
> ><br>
> > > Mike has suggested "nested stack", I personally think this means<br>
> > something a<br>
> > > bit more general to many of us (it includes the concept of aws<br>
> > stacks) and may<br>
> > > I suggest "template resource" - note this is even the class name for<br>
> > > this exact functionality.<br>
> > ><br>
> > > Thoughts?<br>
> ><br>
> > > Option 1) stay as is "provider templates"<br>
> > > Option 2) "nested stack"<br>
> > > Option 3) "template resource"<br>
><br>
> Out of those 3 I like #3 the most, even though not perfect as Mike<br>
> discussed below.<br>
<br>
> ><br>
> > Thanks for rising to the documentation challenge and trying to get<br>
> > good terminology.<br>
> ><br>
> > I think your intent is to describe a category of resources, so your<br>
> > option 3 is superior to option 1 --- the thing being described is<br>
> > not a template, it is a resource (made from a template).<br>
> ><br>
> > I think<br>
> ><br>
> > Option 4) "custom resource"<br>
><br>
> That one sound too generic to me, since also custom python based resource<br>
> plugins are custom resources.<br>
<br>
</div></div>+1.<br>
<br>
'Custom resource' may cause more confusion.<br>
<span class=""><br>
> ><br>
> > would be even better.  My problem with "template resource" is that,<br>
> > to someone who does not already know what it means, this looks like<br>
> > it might be a kind of resource that is a template (e.g., for<br>
> > consumption by some other resource that does something with a<br>
> > template), rather than itself being something made from a template.<br>
> > If you want to follow this direction to something perfectly clear,<br>
> > you might try "templated resource" (which is a little better) or<br>
> > "template-based resource" (which I think is pretty clear but a bit<br>
> > wordy) --- but an AWS::CloudFormation::Stack is also based on a<br>
> > template.  I think that if you try for a name that really says all<br>
> > of the critical parts of the idea, you will get something that is<br>
> > too wordy and/or awkward.  It is true that "custom resource" begs<br>
> > the question of how the user accomplishes her customization, but at<br>
> > least now we have the reader asking the right question instead of<br>
> > being misled.<br>
><br>
> I think "template-based resource" really captures the concept best. And it<br>
> is not too wordy IMO.<br>
> If it helps to explain the concept intuitively, I would be in favor of it.<br>
<br>
</span>Agreed. If it sounds too wordy, just use 'template resource' would be<br>
okay.<br>
<br>
> Regards,<br>
> Thomas<br>
<div class="HOEnZb"><div class="h5">><br>
<br>
<br>
<br>
_______________________________________________<br>
OpenStack-dev mailing list<br>
<a href="mailto:OpenStack-dev@lists.openstack.org">OpenStack-dev@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</div></div></blockquote></div><br></div>