On Sun, Feb 26, 2012 at 4:32 PM, Florian Haas <[email protected]> wrote:
> On 02/26/12 15:31, Rasto Levrinc wrote:
>> I think, I'm never bikeshedding. :) It is a mirror issue but the "iSCSI
>> target" in every short description is redundant,
>
> Which RA are you looking at? iSCSITarget supports 8 different
> parameters; 4 of them have "iSCSI target" in their shortdesc. That's
> hardly "every short description".
This is how my brain remembers it. :)
>
>> since they all belong
>> to the iSCSI target RA, and because the long descriptions are cut in the
>
> Now what, are you talking about longdesc or shortdesc?
I am talking about long shortdescs. E.g.
<shortdesc lang="en">Specifies the iSCSI target implementation ("iet",
"tgt" or "lio").</shortdesc>
is way too long and it abbreviates to something like "Specifies the
iSCSI..." in the GUI. You may not care about this, but many people do.
So I am not nitpicking or anything, this meta-data happens to be my
interface to the resource agents and it used to work quite well in the
past. So generally I think that short-description shouldn't encode that
they specify something, the name of the resource agent and possible
values.
<shortdesc lang="en">Implementation</shortdesc>
or
<shortdesc lang="en">iSCSI target implementation</shortdesc>
would be enough in my opinion and it's nothing shameful to have short
short-descriptions.
Rasto
--
Dipl.-Ing. Rastislav Levrinc
[email protected]
Linux Cluster Management Console
http://lcmc.sf.net/
_______________________________________________________
Linux-HA-Dev: [email protected]
http://lists.linux-ha.org/mailman/listinfo/linux-ha-dev
Home Page: http://linux-ha.org/
