The problem with this is localization.<br>If we want achieve all the activities translated  to all the needed languages <br>(more than 110 active languages in pootle at this moment)<br>you can see including manuals/howtos in the activities we will have a space problem.<br>
We are thinking in include a minimal help, like Implode activity<br>or TurtleArt are doing, But with this minimal help, the TurtleArt po and locale directory<br>are much bigger than all the other data in the activity.<br>
<br>Gonzalo<br><br><div class="gmail_quote">On Tue, Oct 11, 2011 at 6:21 AM, Bastien <span dir="ltr"><<a href="mailto:bzg@altern.org">bzg@altern.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
I have read all the interesting input regarding refreshing the Help<br>
activity and collectively writing up new Sugar lessons.<br>
<br>
One simple idea: why not try to put "howtos" *within* Sugar Activities?<br>
<br>
For example, the Turtle Art activity would have such a folder:<br>
<br>
  how/general-tutorial.txt<br>
  how/drawing-a-square.txt<br>
  how/playing-with-variables.txt<br>
  how/...<br>
<br>
Plain text would be nice, as it could be later exported to HTML and<br>
displayed within Sugar when required.  Plain text is also easier to<br>
handle wrt translation.<br>
<br>
There has been a lot of discussion about accessing the "source" and<br>
I see this "how/" folder something that we could feed with powerful<br>
ideas, sitting between the source code and the activity.<br>
<br>
Also, it would help solving one of the biggest problem: having someone<br>
who is in charge of maintaining this documentation.<br>
<br>
FWIW, I have updated the FLOSS/DOCS presentation in which I summarize<br>
the background ideas and motivations for this proposal:<br>
<br>
  <a href="http://lumiere.ens.fr/%7Eguerry/the-four-letters-word-of-floss-docs.html" target="_blank">http://lumiere.ens.fr/~guerry/the-four-letters-word-of-floss-docs.html</a><br>
<br>
Thanks,<br>
<font color="#888888"><br>
--<br>
 Bastien<br>
_______________________________________________<br>
Sugar-devel mailing list<br>
<a href="mailto:Sugar-devel@lists.sugarlabs.org">Sugar-devel@lists.sugarlabs.org</a><br>
<a href="http://lists.sugarlabs.org/listinfo/sugar-devel" target="_blank">http://lists.sugarlabs.org/listinfo/sugar-devel</a><br>
</font></blockquote></div><br>