[Pacemaker] Doc: Resource templates

[Andrew Beekhof]

On Mon, Dec 12, 2011 at 9:42 PM, Florian Haas <florian at hastexo.com> wrote:
> On Mon, Dec 12, 2011 at 11:20 AM, Gao,Yan <ygao at suse.com> wrote:
>> On 12/12/11 17:52, Florian Haas wrote:
>>> On Mon, Dec 12, 2011 at 10:36 AM, Gao,Yan <ygao at suse.com> wrote:
>>>> On 12/12/11 17:16, Florian Haas wrote:
>>>>> On Mon, Dec 12, 2011 at 10:04 AM, Gao,Yan <ygao at suse.com> wrote:
>>>>>> On 12/12/11 15:55, Gao,Yan wrote:
>>>>>>> Hi,
>>>>>>> As some people have noticed, we've provided a new feature "Resource
>>>>>>> templates" since pacemaker-1.1.6. I made a document about it which is
>>>>>>> meant to be included into "Pacemaker_Explained". I borrowed the
>>>>>>> materials from Tanja Roth , Thomas Schraitle, (-- the documentation
>>>>>>> specialists from SUSE) and Dejan Muhamedagic. Thanks to them!
>>>>>>>
>>>>>>> Attaching it here first. If you are interested, please help review it.
>>>>>>> And if anyone would like to help convert it into DocBook and made a
>>>>>>> patch, I would be much appreciate. :-)
>>>>>>>
>>>>>>> I can tell people would like to see a crm shell version of it as well.
>>>>>>> I'll sort it out and post it here soon.
>>>>>> Attached the crm shell version of the document.
>>>>>
>>>>> As much as I appreciate the new feature, was it really necessary that
>>>>> you re-used a term that already has a defined meaning in the shell?
>>>>>
>>>>> http://www.clusterlabs.org/doc/crm_cli.html#_templates
>>>>>
>>>>> Couldn't you have called them "resource prototypes" instead? We've
>>>>> already confused users enough in the past.
>>>> Since Dejan adopted the object name "rsc_template" in crm shell, and
>>>> call it "Resource template" in the help. I'm not inclined to use another
>>>> term in the document. Opinion, Dejan?
>>>
>>> I didn't mean to suggest to use a term in the documentation that's
>>> different from the one the shell uses. I am suggesting to rename the
>>> feature altogether. Granted, it may be a bit late to have a naming
>>> discussion now, but I haven't seen this feature discussed on the list
>>> at all, so there wasn't really a chance to voice these concerns
>>> sooner.
>> Actually there were discussions in pcmk-devel mailing list. Given that
>> it has been included into "pacemaker-1.2" schema and released with
>> pacemaker-1.1.6, it seems too late for us to change it from cib side
>> now. Unless Dejan would like to rename it from crm shell...
>
> From http://oss.clusterlabs.org/mailman/listinfo/pcmk-devel: "The
> current archive is only available to the list members." Seriously?

Yep.
Without having to broadcast it to the world, I get to tell Lars his
idea is stupid and he gets to tell me I'm an asshole.

> And that's supposedly the list to discuss "issues like 'last commit
> broke the build'" (paraphrasing Andrew, from earlier this year), not
> feature additions. When did this change?

Early feature discussions are fine, to sort out internally what we
think it should look like, but there should have been a followup to
the wider community.
Making sure that happens is my responsibility, unfortunately I've been
highly distracted this year and not generally been able to give the
project the all attention it needs.
Hopefully 2012 will be a better year.