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

[Gonzalo Odiard]

The problem with this is localization.
If we want achieve all the activities translated  to all the needed
languages
(more than 110 active languages in pootle at this moment)
you can see including manuals/howtos in the activities we will have a space
problem.
We are thinking in include a minimal help, like Implode activity
or TurtleArt are doing, But with this minimal help, the TurtleArt po and
locale directory
are much bigger than all the other data in the activity.

Gonzalo

On Tue, Oct 11, 2011 at 6:21 AM, Bastien <bzg at altern.org> wrote:

> I have read all the interesting input regarding refreshing the Help
> activity and collectively writing up new Sugar lessons.
>
> One simple idea: why not try to put "howtos" *within* Sugar Activities?
>
> For example, the Turtle Art activity would have such a folder:
>
>  how/general-tutorial.txt
>  how/drawing-a-square.txt
>  how/playing-with-variables.txt
>  how/...
>
> Plain text would be nice, as it could be later exported to HTML and
> displayed within Sugar when required.  Plain text is also easier to
> handle wrt translation.
>
> There has been a lot of discussion about accessing the "source" and
> I see this "how/" folder something that we could feed with powerful
> ideas, sitting between the source code and the activity.
>
> Also, it would help solving one of the biggest problem: having someone
> who is in charge of maintaining this documentation.
>
> FWIW, I have updated the FLOSS/DOCS presentation in which I summarize
> the background ideas and motivations for this proposal:
>
>  http://lumiere.ens.fr/~guerry/the-four-letters-word-of-floss-docs.html
>
> Thanks,
>
> --
>  Bastien
> _______________________________________________
> Sugar-devel mailing list
> Sugar-devel at lists.sugarlabs.org
> http://lists.sugarlabs.org/listinfo/sugar-devel
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.sugarlabs.org/archive/sugar-devel/attachments/20111011/4c9f308f/attachment.html>