We still need a lot of L10n activity to get it fully ready for wide use in Sugar Deployments in non-English countries.
http://translate.sugarlabs.org/projects/help_content/ On Mon, Nov 4, 2013 at 2:06 AM, Iain Brown Douglas <i...@browndouglas.plus.com> wrote: > Help 17 is at a point close to release, but in some essential ways, is, as > yet, unfinished. > > It is largely updated in content, but there is still some very important > changes that have not been crossed off the list on this > page:http://wiki.laptop.org/go/Help_Activity_refresh/0.98 > > Help 17 is already a nearly complete set of Sugar 1.00 documentation. > > I came to the project very recently, Gonzalo Odiard has spent more time > supporting me to learn the process, than I have so far contributed. > > This will be an inadequate description, which is why I write. Gonzalo > has modified the source of Activity Help, so that the version of Help in > the link below includes a self-installing, fully user editable form of > Help. Please test if you can. I tested it in sugar-build and SoaS. It works > nicely. > > *To Get this Activity* > ---------------------- > > Right now if you do: > > git clone gitori...@git.sugarlabs.org:help/mainline.git > > you will get the help activity _with_ the sources included. > > You can install it in your development environment doing: > > cd mainline > > ./setup.py dev > > If you have the Activity Help already installed, uninstall it first. > > Now you can modify any .rst file in /mainline/source directory or the > images in the /mainline/images directory, > > and to create the html files, you only need do: > > > make html > > * In Sugar > You don’t need to restart the activity to see the changes, can do click > with the secondary button, and select reload. > > > * In any other Linux environment > The output of make html is in /mainline/html, and is opened by opening > index.html in a browser, it is easy to see the changes as you work. > > > * Features > Help already allows internationalisation of the content. > > *Next steps* > ------------ > > I think this is a really good way of producing documentation in the field. > > But it has taken me three weeks to get to the point where I can contribute! > On my hard drive, I have a variant of the above, that I would like to > sell to you as "Help Doers Kit". > > *Help Doers Kit* > ---------------- > > I replaced the "regular" index, with one containing "Help Doers Kit", > which is about 4 pages I have written, containing: > > all I know about How To write and contribute to Activity Help > an improving version of the content of this e-mail > a sandbox. > I have already used it to start to create some New-to-Sugar, pages which > I hope to submit in due course. > > The Help Doers Kit allows someone with no coding experience, > * to practice on the software, > * to start to write documentation from scratch, > * to write self-help pages, which remain in the users copy of Help, > * to edit existing Help pages, and have them patched into the next > Help Activity, > * to develop the Help Doers Kit itself, > * to have a common low-tech platform for collaboration, > * to develop the Help Activity's look, feel, and features, > * to, potentially, write attractive documentation available to > distribute as .html web pages, or How_to_change_the_world.xo > > > Would there be any market for Help Doers Kit, and what should I do next? > > Iain Brown Douglas > aka inkyfingers > > > > > > > _______________________________________________ > Sugar-devel mailing list > Sugar-devel@lists.sugarlabs.org > http://lists.sugarlabs.org/listinfo/sugar-devel _______________________________________________ Sugar-devel mailing list Sugar-devel@lists.sugarlabs.org http://lists.sugarlabs.org/listinfo/sugar-devel