Tip: Write good descriptions

Tuesday, May 27, 2008 at 10:31 AM

Posted by James Yum, Developer Programs Engineer (Google Desktop Team)

The <description> tag in the gadget.gmanifest provides the content that's displayed in the gadget installation dialog.

Perhaps more importantly, that content is also used for the description text in the gadget gallery and the Add gadgets dialog, which people read when browsing for gadgets. You can see this description highlighted in the following screenshot.



Since this description is used in the gallery, it needs to be clear and correct. A bad description can confuse users or scare them away. Before you submit your gadget, run the description text through a spell checker. Also, try to envision it through the eyes of a user. If you need help, feel free to consult the developer group, just as you would for a technical issue.

Have a tip you'd like to share? Send it to gd-developer AT google DOT com. To see all tips, choose the Tips label.