Re: Potential volunteer offering technical writing

2011-10-30 Thread Sridhar Dhanapalan
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 that we can point her in the direction of? She currently works with developers to write

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

Re: Potential volunteer offering technical writing

2011-10-20 Thread Tabitha Roder
On 20 October 2011 11:21, Christoph Derndorfer christoph.derndor...@gmail.com wrote: not sure what the exact time difference is between San Francisco and NZ but maybe we could set up a Skype call between Rachel, you, and us in SF to coordinate our documentation efforts? Cheers, Christoph

Re: Potential volunteer offering technical writing

2011-10-19 Thread Tabitha Roder
On 4 October 2011 16:18, Martin Langhoff martin.langh...@gmail.com wrote: And the FLOSS Manuals feed into the Help Activity, so work there pays of many times over... So how do we feed the FLOSS manual into the Help activity? Rachel is keen to help, but keen to see her work on the XO. Is the

Re: Potential volunteer offering technical writing

2011-10-19 Thread Gonzalo Odiard
We need help writing, and translating in FLOSS. I can help updating the activity. Gonzalo On Wed, Oct 19, 2011 at 4:53 PM, Tabitha Roder tabi...@tabitha.net.nzwrote: On 4 October 2011 16:18, Martin Langhoff martin.langh...@gmail.comwrote: And the FLOSS Manuals feed into the Help Activity, so

Re: Potential volunteer offering technical writing

2011-10-19 Thread Christoph Derndorfer
Tabitha, not sure what the exact time difference is between San Francisco and NZ but maybe we could set up a Skype call between Rachel, you, and us in SF to coordinate our documentation efforts? Cheers, Christoph Am 19.10.2011 22:49 schrieb Gonzalo Odiard gonz...@laptop.org: We need help

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

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

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

2011-10-11 Thread Walter Bender
On Tue, Oct 11, 2011 at 6:23 AM, Gonzalo Odiard gonz...@laptop.org wrote: 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

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: Potential volunteer offering technical writing

2011-10-04 Thread Christoph Derndorfer
On Tue, Oct 4, 2011 at 5:18 AM, Martin Langhoff martin.langh...@gmail.comwrote: Hi Tabs! that's great! Here's an idea: I was looking at recently at the FLOSS Manuals manuals for Sugar and activities... and they are a bit dated -- they cover Sugar 0.86 or so. Screens have changed quite a bit

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

Re: Potential volunteer offering technical writing

2011-10-03 Thread Martin Langhoff
Hi Tabs! that's great! Here's an idea: I was looking at recently at the FLOSS Manuals manuals for Sugar and activities... and they are a bit dated -- they cover Sugar 0.86 or so. Screens have changed quite a bit :-) and some procedures are much simpler (ad hoc networking for example). And the