[Dextrose] Need documentation written.

[Bernie Innocenti]

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/