[Sugar-devel] "Howtos" within Sugar Activities (was: Potential volunteer offering technical writing)

[Sean DALY]

Sugar is disorienting for adults including teachers used to
traditional systems, so help is... helpful.

MacOS 7/8/9 style help balloons (toggled on/off systemwide? per
Activity?) would I think aid in discovery of both Sugar and a new,
unknown Activity.

Sean


On Tue, Oct 11, 2011 at 4:51 PM, samy boutayeb <s.boutayeb at free.fr> wrote:
> Le mardi 11 octobre 2011 à 10:23 -0400,
> sugar-devel-request at lists.sugarlabs.org a écrit :
>> Also, by including even simple help strings, the burden on the
>> translator when from a few hundred single-word strings to many many
>> long sentences. Even so, the real explanations are found in the wiki.
>>
>
> More strings equal more work but, at the same time, more useful
> contextual information! This is a big plus for the translator as it
> helps disambiguïse short commands/menus/strings from the user interface!
>
> Generally speaking, a carefully designed help system (regardless of its
> form) is a courtesy for the end users!
>
>
>> I took a different approach in Turtle Confusion: I added hints in the
>> form of short programs in the help. Not sure how to scale that
>> approach.
>
> A possible extension could be to merge those "tooltips" and to build a
> "glossary" of the functions available in this activity, as a reference
> accompanying a more formal user manual (either online or online).
>
> _______________________________________________
> Sugar-devel mailing list
> Sugar-devel at lists.sugarlabs.org
> http://lists.sugarlabs.org/listinfo/sugar-devel
>