[Dextrose] Need documentation written.

Steven Parrish smparrish at gmail.com
Mon Sep 27 13:14:45 EDT 2010


On Mon, Sep 27, 2010 at 12:29 PM, Bernie Innocenti <bernie at codewiz.org> wrote:
> On 09/27/10 17:01, Steven Parrish wrote:
>> Please see
>>
>> http://bugs.sugarlabs.org/ticket/2371
>> http://bugs.sugarlabs.org/ticket/2372
>>
>> Need someone to take on these very simple tasks.  Coding is not
>> required for this, however familiarity with how the activities work
>> would be a plus.  This would be a good task for someone who wants to
>> learn the functionality and codebase involved.
>
> We could create 4 subpages of Dextrose with the screenshots of the
> Backup and Restore functions:
>
>  * Backup to USB
>  * Backup to XS
>  * Restore from USB
>  * Restore from XS
>
> In order to do the backup/restore to the schoolserver, one needs to be
> registered. If nobody has a schoolserver handy, I could take the
> screenshots tonight and upload them to the wiki.
>
>
> On a side note, I think there shouldn't be a need for external
> documentation in the wiki. If some functionality isn't already
> discoverable and easy to use, we should work harder to improve the UI.
>
> I think Tincho actually did a very good job with the Backup/Restore UI.
> The most non-obvious part of the entire procedure is registering to the
> schoolserver. There's a patch by dsd to make the registration happen
> automatically in the background, but it's written for Sugar 0.82 and
> needs some reworking.
>
> Other areas of minor UI improvement would be a better progress bar
> showing *real* progress (currently it moves all the time even when the
> network is down, thus misleading users). Perhaps we could also improve
> the graphics at the top to better convey the data flow between the
> journal and the particular backup device.
>
> Note that I'm not opposed to documentation: even when it's superfluous,
> it serves to showcase new features in Dextrose. I just think that
> documentation shouldn't become a workaround a sub-otimal UI.
>
> --
>   // Bernie Innocenti - http://codewiz.org/
>  \X/  Sugar Labs       - http://sugarlabs.org/
>

I'm always open to making a more user friendly UI that will require
little to no documentation.  So why do you file 2 new bugs specifying
what you think needs to be done and I'll find some people to put on
it.

Steven


More information about the Dextrose mailing list