[OpenAjaxIDE] IDE Issue 4: Long names and/or short names
jferrai at us.ibm.com
Wed Dec 5 14:56:17 PST 2007
IDE Issue 4: Long names and/or short names
Should we have one description field for describing the widgets, or perhaps
two description fields (one short and one long), or perhaps something else?
Existing industry practice
Ext.js 2.0 uses JSDoc to document their widgets and only includes a
single short descriptive summary as part of the class definition
Dojo 1.0 (i.e., dijit) has no inline documentation about its widget
Adobe has a requirement for a short name (<=23 characters?) to fit on
Apple Dashboard Info.plist file has a non-localizable CFBundleName
and a localizable CFBundleDisplayName
Google Gadgets <module> file has a single string, the title<code>
attribute on the <code><ModulePrefs> element.
Jon's proposed recommendation
Our metadata should include both a short name and a long name field. The
short name field would be optional and localizable; if not provided, IDEs
SHOULD construct a short name automatically using available information,
would be required and localizable.
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the IDE