The most effective help is individual instructions and examples, one or two sentences each, integrated directly into the interface it is providing help on. Upstreams whose software is included in Ubuntu (especially the less-often used ones) should be encouraged to add such hints, through a section in the HIG and friendly evangelism on mailing lists etc.


People other than programmers are highly reluctant to use anything in the Help menu. The most useful help is tips and and hints embedded in the software itself, especially in dialogs and rarely-used windows.

Use cases



Current examples of embedded help:


Since this approach is distributed across dozens of upstream projects, it should be implemented as a section in the GNOME HIG, then evangelized to individual projects.

Outstanding issues


EmbeddedHelp (last edited 2008-08-06 16:32:01 by localhost)