On 02/27/12 07:38, Rasto Levrinc wrote:
> 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.

So you're proposing either a shortdesc that's _identical_ to the
parameter name -- doesn't do a fat lot of good -- or one that contains
the parameter name plus the string "iSCSI target" which you've been
complaining about upthread? Does not compute.

Let me suggest that this discussion is getting us nowhere. The
shortdescs stay as they are until someone comes up with a real improvement.

Thanks for reporting the other issues, though.

Cheers,
Florian

-- 
Need help with High Availability?
http://www.hastexo.com/now
_______________________________________________________
Linux-HA-Dev: Linux-HA-Dev@lists.linux-ha.org
http://lists.linux-ha.org/mailman/listinfo/linux-ha-dev
Home Page: http://linux-ha.org/

Reply via email to