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 <div class="gmail_quote">On Tue, Oct 11, 2011 at 6:21 AM, Bastien <<a href="mailto:bzg@altern.org">bzg@altern.org</a>> wrote: <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 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: <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> Thanks, -- Bastien _______________________________________________ Sugar-devel mailing list <a href="mailto:Sugar-devel@lists.sugarlabs.org">Sugar-devel@lists.sugarlabs.org</a> <a href="http://lists.sugarlabs.org/listinfo/sugar-devel" target="_blank">http://lists.sugarlabs.org/listinfo/sugar-devel</a> </blockquote></div>