Re: [Sugar-devel] Potential volunteer offering technical writing

2011-10-30 Thread Christoph Derndorfer
On Mon, Oct 31, 2011 at 1:45 AM, Sridhar Dhanapalan srid...@laptop.org.auwrote: On 30 September 2011 19:51, Tabitha Roder tabi...@tabitha.net.nz wrote: Hi If we had a volunteer (English Native language) professional technical writer, what writing would be of most use to OLPC or Sugar

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

2011-10-11 Thread Bastien
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

Re: [Sugar-devel] Potential volunteer offering technical writing

2011-10-06 Thread Cherry Withers
Hi Martin, Could you please shed a light on which manuals in FlossManuals make up the Help Activity? Some of us who will be jumping in to refresh it don't know much about the history. Right, here I am not sure if you have seen: the current Help activity is a combination of several floss manuals

Re: [Sugar-devel] Potential volunteer offering technical writing

2011-10-06 Thread Martin Langhoff
On Oct 6, 2011 6:28 PM, Cherry Withers cwith...@ekindling.org wrote: Could you please shed a light on which manuals in FlossManuals make up the Help Activity? Some of us who will be jumping in to refresh it don't know much about the history. To be honest, I don't really know. Here's what I

Re: [Sugar-devel] Potential volunteer offering technical writing

2011-10-06 Thread rihowa...@gmail.com
I think what was used to generate the help was the FLOSS Manuals Remix feature, http://en.flossmanuals.net/index.php?plugin=remix . The workflow would be to identify the source of the existing help text starting with the Sugar and XO books. Edit the source material then use the remix feature. I

Re: [Sugar-devel] Potential volunteer offering technical writing

2011-10-06 Thread Cherry Withers
Thanks Martin! Unless they're named differently or have another version in a different name, here's what I can find when I do a search on All Manuals: XO manual (Introduction, Getting Started, Battery, Network, Support, Appendices): http://booki.flossmanuals.net/xo/_draft/ Browse Activity

Re: [Sugar-devel] Potential volunteer offering technical writing

2011-10-05 Thread Christoph Derndorfer
On Wed, Oct 5, 2011 at 7:20 AM, Chris Leonard cjlhomeaddr...@gmail.comwrote: On Wed, Oct 5, 2011 at 1:12 AM, Chris Leonard cjlhomeaddr...@gmail.com wrote: On Tue, Oct 4, 2011 at 7:19 PM, Martin Langhoff martin.langh...@gmail.com wrote: On Tue, Oct 4, 2011 at 6:25 PM, Chris Leonard

Re: [Sugar-devel] Potential volunteer offering technical writing

2011-10-05 Thread Martin Langhoff
On Wed, Oct 5, 2011 at 1:12 AM, Chris Leonard cjlhomeaddr...@gmail.com wrote: L10n of long-form content is an area where I think there are some excellent bits and pieces, but I'm not convinced that there is a really nice end-to-end solution yet.  I think very highly of FLOSSManuals as a book

Re: [Sugar-devel] Potential volunteer offering technical writing

2011-10-05 Thread Chris Leonard
On Wed, Oct 5, 2011 at 9:41 AM, Martin Langhoff martin.langh...@gmail.com wrote: On Wed, Oct 5, 2011 at 1:12 AM, Chris Leonard cjlhomeaddr...@gmail.com wrote: L10n of long-form content is an area where I think there are some excellent bits and pieces, but I'm not convinced that there is a

Re: [Sugar-devel] Potential volunteer offering technical writing

2011-10-05 Thread Martin Langhoff
On Wed, Oct 5, 2011 at 10:28 AM, Chris Leonard cjlhomeaddr...@gmail.com wrote: AFAIK FLOSSManuals software infra is being worked on, and that ... By no means should my *critique* of FLOSSManuals L10n be taken for *criticism* of FLOSSManuals,  As both a community and a tool, they Oh, all I

Re: [Sugar-devel] Potential volunteer offering technical writing

2011-10-05 Thread Gonzalo Odiard
As for the use of FLOSSManuals as the source and L10n workflow for the Help Activity, sadly, I think the more pressing challenge may be the lack of documentation of the process employed by Seth and his collaborators in the original Help Activity creation from FLOSSManual sources. I am not

Re: [Sugar-devel] Potential volunteer offering technical writing

2011-10-05 Thread Martin Langhoff
On Wed, Oct 5, 2011 at 12:13 PM, Gonzalo Odiard gonz...@laptop.org wrote: As for the use of FLOSSManuals as the source and L10n workflow for the Help Activity, sadly, I think the more pressing challenge may be the lack of documentation of the process employed by Seth and his collaborators in

Re: [Sugar-devel] Potential volunteer offering technical writing

2011-10-05 Thread Gonzalo Odiard
Right, here I am not sure if you have seen: the current Help activity is a combination of several floss manuals mixed together. And it looks like it may have some tweaks and customizations. Quoting a contemporary thinker we can use a directory capable filesystem :) Gonzalo

Re: [Sugar-devel] Potential volunteer offering technical writing

2011-10-05 Thread Martin Langhoff
On Wed, Oct 5, 2011 at 12:50 PM, Gonzalo Odiard gonz...@laptop.org wrote: Right, here I am not sure if you have seen:  the current Help activity is a combination of several floss manuals mixed together. And it looks like it may have some tweaks and customizations. Quoting a contemporary

Re: [Sugar-devel] Potential volunteer offering technical writing

2011-10-05 Thread Gonzalo Odiard
On Wed, Oct 5, 2011 at 1:52 PM, Martin Langhoff martin.langh...@gmail.comwrote: On Wed, Oct 5, 2011 at 12:50 PM, Gonzalo Odiard gonz...@laptop.org wrote: Right, here I am not sure if you have seen: the current Help activity is a combination of several floss manuals mixed together. And it

Re: [Sugar-devel] Potential volunteer offering technical writing

2011-10-04 Thread Chris Leonard
All, In any refresh of the XO manual (Help Activity), I would very much appreciate if some structural choices could be made to facilitate the internationalization of the text so that it can be converted into PO files and posted on Pootle for translation into a renewed Help Activity. That is not

Re: [Sugar-devel] Potential volunteer offering technical writing

2011-10-04 Thread Martin Langhoff
On Tue, Oct 4, 2011 at 6:25 PM, Chris Leonard cjlhomeaddr...@gmail.com wrote: In any refresh of the XO manual (Help Activity),  I would very much appreciate if some structural choices could be made to facilitate the internationalization of the text Agreed on the general goal. My understanding

Re: [Sugar-devel] Potential volunteer offering technical writing

2011-10-04 Thread Walter Bender
On Tue, Oct 4, 2011 at 7:19 PM, Martin Langhoff martin.langh...@gmail.com wrote: On Tue, Oct 4, 2011 at 6:25 PM, Chris Leonard cjlhomeaddr...@gmail.com wrote: In any refresh of the XO manual (Help Activity),  I would very much appreciate if some structural choices could be made to facilitate

Re: [Sugar-devel] Potential volunteer offering technical writing

2011-10-04 Thread Gonzalo Odiard
I think the easier way is have a different floss manual by language. The Help Activity is only a shell, we can create a e-pub or a content bundle if we want, but doing the i18n at this level will be a nightmare. Gonzalo On Tue, Oct 4, 2011 at 7:25 PM, Chris Leonard cjlhomeaddr...@gmail.comwrote:

Re: [Sugar-devel] Potential volunteer offering technical writing

2011-10-04 Thread Chris Leonard
On Tue, Oct 4, 2011 at 7:19 PM, Martin Langhoff martin.langh...@gmail.com wrote: On Tue, Oct 4, 2011 at 6:25 PM, Chris Leonard cjlhomeaddr...@gmail.com wrote: In any refresh of the XO manual (Help Activity),  I would very much appreciate if some structural choices could be made to facilitate

Re: [Sugar-devel] Potential volunteer offering technical writing

2011-10-04 Thread Chris Leonard
On Wed, Oct 5, 2011 at 1:12 AM, Chris Leonard cjlhomeaddr...@gmail.com wrote: On Tue, Oct 4, 2011 at 7:19 PM, Martin Langhoff martin.langh...@gmail.com wrote: On Tue, Oct 4, 2011 at 6:25 PM, Chris Leonard cjlhomeaddr...@gmail.com wrote: In any refresh of the XO manual (Help Activity),  I