Subscribe to RSS
Archive for the ‘OLPC’ Category:
Climb collaboration levels with me in Atlanta
Photo courtesy lollaping
I finished my presentation about Climbing the Levels of Collaboration for the Collaboration Institute at the STC Summit and I’m so excited about it I can’t stand it! True confession: I was up until 1:00 AM finishing it up and uploaded it quite late.
I found this great collaboration exercise that I’ve incorporated into the session. So we’ll be drawing with Crayola markers. Maybe even collaboratively. I’m hoping for quite the Back of the Napkin experience. 
This session walks through the different ways you can collaborate with your users (and co-workers) especially when wikis are enabling the collaboration. I’ll be talking about Book Sprints and FLOSS Manuals and tell stories from my experiences. I was inspired by the examples of amazing group accomplishments described in Clay Shirky’s book, Here Comes Everybody: The Power of Organizing Without Organizations
Groups can take action even quicker than ever before in history thanks to tools that amplify group communications such as wikis, blogs, and instant messaging. There are three distinct levels of collaboration that a group can attain and what they accomplish directly correlates to the level of collaboration.
People I talked with definitely wanted to know best practices for wiki authoring techniques. One person even wanted to know how to incorporate user-generated content into their help system. I’ve heard that request before – such as, how could you import wiki content into Robohelp? Also, what I learned at last weeks’ talk was a high number of people wanting recommendations for wiki engines. There are over 90 to choose from on wikimatrix.org. Eep. Writers also wanted to how to organize content on a wiki. I won’t promise to have all the answers or any of the answers but I am looking forward to sharing my stories and hearing yours.
What is Anne Gentle up to?
I finally feel some energy returning after my eye injury about a month ago, although my right eye remains dilated which still means that side is a bit out-of-focus and I don’t like driving at night. I feel like I need to give a status update or some such. So here goes.
Winter Camp
With luck my eye should be just fine in time for a big event coming up: Winter Camp 09 the first week of March. I’ll be representing and working for FLOSS Manuals at this event, held in Amsterdam. From the description, it will be an amazing week:
Network Cultures Winter Camp will be a mix of presentations and work spaces with an emphasis on getting things done. It will be a four-day program of work spaces and plenary presentations, in which a dozen networks (each of which has 5-15 people) can work on their specific current topics.
The format was inspired by a cardboard box art installation that activates a temporary warehouse of contemporary knowledge from what I can gather from a translation of the page, Re-fitting ideas. Come on, that’s incredible. I am so thrilled to be a part of it. And I know it’s going to be a week of hard work.
Preschool website completed, using Wordpress 2.7
We’ve also finished the preschool website I mentioned in my interview with Michael Silverman of Duo Consulting. We used WordPress hosted at Midas Networks. I recorded some screencasts with Jing to show other parent volunteers how to edit content and work with images. All the photos on the site were taken by parents so it’s quite the “do-it-yourself” website. I am hoping that Wordpress 2.7 will be easy enough for even those in our volunteer and staff group who are not technically savvy but still give us the growth towards more content creators that we have in our goals for the site.
FLOSS Manuals and OLPC
We’ve sold over 200 copies of the OLPC Laptop Users Guide on Lulu.com, and Adam Hyde gave a copy of one of FLOSS Manuals’ books to Bob Young, the CEO of Lulu, while they were at the O’Reilly Tools of Change conference. Impressive. I still plan to make the Sugar Users Guide better. Adam Hyde and I are working on a book about how to run a Book Sprint in FLOSS Manuals, naturally, and we would welcome additional contributors.
DITA and Web 2.0
I’ve been approached to help put a public face on standards for DITA and Web 2.0 projects such as DITA for wikis (an example is Lisa Dyer’s DITA2Wiki project on SourceForge) and DITA for blogs (another example is DITA to Wordpress or DITA and microformats).
STC Intercom Editorial Advisory Panel
I’ve been pretty impressed with the STC Intercom issues in 2009 so far, but I wrote one of the articles so perhaps my judgement would be playing favorites. I would like to gather feedback from STC members and non-members who read the articles – how’s the content grabbing you this year?
Author-it 5.2
It looks as though 5.2 is the version of Author-it that will allow us to upgrade from 4.5. Our content just wouldn’t publish adequately (Word or HTML) on 5.0 or 5.1, but now that 5.2 is released, fingers crossed, we’ll be moving to 5.2 soon. I should write a blog post about some of our testing on our 20,000+ object database. I’m getting used to the Ribbon Bar as I continue to work in Word 2007, and Author-it’s 5.x interface feels a lot like Word 2007.
Writing a book, do tell me what you want to know
Last but certainly not least, I’m working with a professional editor to try to finalize my book about documentation as conversation that examines the power of social media for writing projects. It walks through the myriad of possibilities of different types of social media tools and analyzes how writers and communities are using these tools for technical documentation. Look for it this spring!
InfoSlicer is released to the world
Let the remixing begin. I just got word today that the Infoslicer project has been checked into the Sugar code repository at http://git.sugarlabs.org/projects/infoslicer, and released under the GPLv2 license. Can I get a whoohoo? Oh yeah!
Infoslicer is a Sugar Activity that enables students and instructors around the world to assemble Wikipedia articles into new information packages. Under the covers one of the technologies that makes this possible is the Darwin Information Typing Architecture (DITA). I first wrote about the InfoSlicer last fall, in Wikislicing project gets real – introducing InfoSlicer as a Sugar Activity with a picture of students using scissors to re-assemble Wikipedia articles.
If you want to download the Activity to your XO or another computer with Sugar installed (here’s how) to try it out yourself, go to http://sugarlabs.org/go/Activities/InfoSlicer and install the Activity (here’s how).
I have downloaded it to my XO in anticipation of showing it off at the next XO Austin Users Group meeting and the install was straightforward. I’ll get it on a USB stick to share at the meeting (2/16 at Central Market on N. Lamar in Austin at 6:30). Here’s a screenshot – and be sure to check out the YouTube video!
Laura Cowen notes that the xo package that you download doesn’t contain any sample articles from Wikipedia (which ideally it would to help you get up and running more quickly using the tutorial). You can use InfoSlicer without these sample articles (you download Wikipedia articles from within InfoSlicer anyway). If anyone is able to re-compile the xo package with sample articles in it, Laura can provide instructions on where to put the sample articles in the package so that InfoSlicer automatically picks them up when it starts. Who wants to create the wikislice seen ’round the world?
A nice OLPC story
Lifted in whole from the December 1, 2008 OLPC Community update – what a neat story.
Cambridge: Samuel Dalembert, the 6-11 starting center for the NBA’s
Philadelphia 76ers, is a devotee of technology whose personal foundation
supports a variety of youth projects. Samuel attended the OLPC country
meetings in May. Recently, he was watching an episode of “House” on
television when he saw a G1G1 spot. Samuel immediately volunteered to do
a commercial for us, too. He will also make sure that XOs are deployed
to support his projects in his native Haiti, the Dominican Republic and
elsewhere, and will encourage other NBA players to get behind OLPC.
OLPC Book Ready for G1G1!
Tomorrow, Monday, November 17 is the launch of the new Give One Get One campaign for 2008 – meaning, once again you can buy your very own XO laptop. The tagline for this year is Give a Laptop. Get a Laptop. Change the World.
You can buy yours at amazon.com/xo.
All our community author’s work has culminated into a book that’s now for sale on Lulu, and as soon as we can get it listed on Amazon, the book will be available there as well.
The back cover of all FLOSS Manuals books say “Please copy!” We fully intend for the OLPC Laptop Guide to available to anyone who wants one. You can purchase a printed copy at Lulu for a modest markup (that funds future booksprints and the like), or download the PDF, or remix the content at FLOSSManuals.net.
The neat thing is, once you’re done with a real book, you can pass it on to the next person who wants to learn about their XO. My hope is that XO users around the world will get a book and pass it on.
Shows front and back covers of the Laptop Guide for OLPC
BookSprint post on OLPC News web site
Here’s a post I wrote about the BookSprint published on OLPC News, an independent site that boasts about 5,000 readers a day.
OLPC / Sugar – Book Sprint, part II: Action
To build a set of books in five days takes a lot of preparation work that Adam Hyde, founder of FLOSS Manuals, described in a prior post. Christoph also encouraged me to talk about what it was like to participate as a writer in the Book Sprint. Over all, it was very similar to a footrace of the same name, hosting a group of writers in a room cranking out as much usable content as possible! Read more…
FLOSS Manuals book store now open!
I went out for a run this morning and realized it has been a year this very week since I started my volunteer work with OLPC. This project was my first foray into the open source world from a contributor standpoint, and I can’t believe how it has paid back at least tenfold in the people I’ve met, the lessons I’ve learned, and the technology I’m now acquainted with.
What did it take? For me, time and faith and trust in others.
This is an amazing day and it has been an amazing journey. And what is significant about today? We now have a FLOSS Manuals bookstore and we now have a real, hold-it-in-your-hands, put-it-on-your-bookshelf, book. With a cover designed by someone who works at MOMA no less. (Wow!) With content carefully authored by people who learned and knew enough about the technology while also considering who would read the chapters and what they want to do with the technology.
I’m happily and proudly displaying the distributable FLOSS Manuals bookstore on my blog – see the sidebar on the left? That’s a bit of HTML code that anyone can display and host a portable virtual book store on any web site. Here’s the code.
<style>
@import url("http://en.flossmanuals.net/bookstore/bookstore.css");
</style>
<img src="http://en.flossmanuals.net/bookstore/bookstore.gif"
style="margin-bottom:5px;">
<script type="text/javascript"
src="http://stores.lulu.com/feed.php?fStore=flossmanuals&fFormat=js"></script>
You can always download the PDF for free, but by buying a book you support the FLOSS Manuals project and help support the uptake and usefulness of free software by providing free documentation. Your money is well spent as these paperbacks are high quality and can take wear and tear. My hope is that people will read it and that the book will be passed on to the next learner.
BookSprint Laps
What is a continuation of a BookSprint called? I’m not sure what to call it, nor do I know which metaphors might fit, but there has been some additional energy emanating from the Austin-based OLPC BookSprint. In the week following the FLOSS Manuals BookSprint, OLPC has energized interns and staff members to continue refining existing chapters and adding new chapters also. As maintainer of the doc, I’ve been watching the changes on notifications and will make my own minor edits, but for the most part I’m just watching in delight at the outpouring of content. Another win for us writers is that the manuals will be remixed, output as HTML, and included on the XO laptop itself for deployments. My sincere hope is that good documentation will prove helpful to the support gang who work so hard on
I’m also completely tickled by the emails of encouragement and thanks coming from all parts of the community. Here are some excerpts from an email from David Farning, an awesome Sugar Labs community guy who I know I can learn a lot more from:
I realized this was not just a couple of programmers trying to throw
together a wiki as I watched Janet Swisher intensely studying the XO’s
battery. Turns out she trying to determine if the installing the
battery section could be misread. From my experience, a programmer
would have said, “If they can’t figure out how to put the battery in,
what’s the point of a fine manual.”David Cramer, a tech writer at Motive, the company that hosted the
event, provided a excellent takeaway on tech writing. ’When I write, I
write for one person. Usually, one person reads what I write. The rest
of the department just asks him….’ Very on point for SL (Sugar Labs) and OLPC.
With our limited resources, we can’t afford to target a broad audience.
But, can afford to target ‘that one guy’ who can spread our message.
Technical Communication bloggers have also caught on to the uniqueness and excitement of this community documentation site, FLOSS Manuals. Tom Johnson, Heidi Hanson, and Charles Jeter talk about it around the 7:30 mark of this podcast:
Quotes from the audio -
about the site “I’ve never seen anything quite like it…”
about the BookSprint “an amazing collaborative community type of event…”
about the FLOSS Manuals community “the social organization of it is going to give it it’s best foot forward…”
Adam Hyde has done an excellent round up of blog entries that talk about FLOSS Manuals. He took a picture of these covers of the books. They look so good and it’s so satisfying to see a book deliverable so quickly.
Additional excitement for this week centers around translation of the content. FLOSS Manuals has a side-by-side translation interface and all of the wiki interface is also in the language of the translators choice. See fa.flossmanuals.net to see the Farsi FLOSS Manuals.
XO BookSprint instructions
Adam Hyde of FLOSS Manuals wrote up these instructions for how to get involved with the BookSprint going on this week. I’m hoping to write blog entries that describe the planning sessions and surrounding practical advice for this type of writing sprint, but I wanted to let my readers know the basic overview of how to participate this very week. Thanks Adam Hyde! Adam’s presenting at DocTrain East this fall, if you’d like to know more about FLOSS Manuals and the remixing the system enables.
XO BookSprint
This week in Austin, Texas a team of writers are gathering together to immerse themselves in a one week intensive documentation jam.
The purpose of the Book Sprint is to produce documentation in 1 week to support the forthcoming 2008 roll-out off the OLPC G1G1. The team in Austin consists of members of FLOSS Manuals (Adam Hyde, Anne Gentle), OLPC (Adam Holt), Sugar (David Farning, Walter Bender), and the Austin XO Users Group, and YOU! We have set up the online tools so you too can contribute! To make a contribution please do the following :
1. Register
To contribute to the documentation you can register at FLOSS Manuals :
http://en.flossmanuals.net/register
2. Contribute!
There are several manuals planned to be finished by the end of the week
(August 29) including a Sugar manual, an XO manual, and 5 Sugar
Activities manuals. You can see the structure of the manuals here:
Sugar :
http://en.flossmanuals.net/bin/view/Sugar
XO (OLPC Hardware) :
http://en.flossmanuals.net/bin/view/XO
Sugar Activities :
http://en.flossmanuals.net/bin/view/Browse
http://en.flossmanuals.net/bin/view/Chat
http://en.flossmanuals.net/bin/view/Record
http://en.flossmanuals.net/bin/view/Terminal
http://en.flossmanuals.net/bin/view/Write
To contribute you must register and then select a manual and a chapter
to work on. if it is not marked ‘complete’ then press the edit button!
Its as simple as that.
Contributions can include cleaning up layout, spell checking, adding
images, proof reading, or taking responsibility for writing one of more
chapters. You don’t have to be a technical writer or a super geek, you
just need to know how to write.
If you need to ask us questions about how to contribute then join the
chat room listed above and ask us! We look forward to your contribution!
For more information on using FLOSS Manuals you may also wish to read
our manual :
http://en.flossmanuals.net/FLOSSManuals
3. Chat
Its a good idea to talk with us so we can help co-ordinate all
contributions. We have a chat room for this using Internet Relay Chat
(IRC). If you know how to use IRC you can connect to the following :
server : irc.freenode.net
channel : #olpc-content
If you do not know how to use IRC then visit the following web based
chat software in your browser :
http://irc.flossmanuals.net/
Information on how to use this web based chat software is here :
http://en.flossmanuals.net/FLOSSManuals/IRC
BookSprint for Floss Manuals writing for the XO and Sugar
I’ve been busy lately working on plans for a Floss Manuals BookSprint. A BookSprint is a week-long concentrated effort of technical writers getting together to create a manual for free, libre open source software products. BookSprints are like a workshop where writers come together to learn how to write good user documentation. BookSprints are also a social experience where writers come together to form a community who share common goals and experiences.
Writers are giving a week’s time to be curators of information housed in wikis and websites everywhere, bringing it all together into the FLOSS Manual TWiki implementation to be ready for online viewing or gorgeous print output. If you’re interested in joining us for a day or all week, we’d love to have you. We’re planning to invite local students to the event also.
This picture shows the recent Inkscape BookSprint held in Paris France. We’re planning to hold the XO/Sugar BookSprint here in Austin, but I’m guessing the collection of laptops and cables will be the same here as there!
Inkscape BookSprint in Paris
In this case, we’ll produce a comprehensive manual for the kids, families, and teachers using the little green XO laptop. While the manual that exists at flossmanuals.net/olpc_simple is a targeted effort, it is outdated for the new line drawn between hardware (XO) and operating system (Sugar). Our hope is to expand the manual in advance of the new expanded Give 1 Get 1 program will give educators and children a chance to learn about their laptop, repair it, program with it, and teach others.
What can you do to help? Right now, I’m raising money and asking for in-kind donations to help with this concentrated effort. Here are some ideas, although you can come up with creative ideas yourself if you want!
$500 would provide hotel accommodations for a writer
$250 would provide a catered lunch for all the writers
$100 would provide gas money for many writers all week
Updated to add: You can also directly give donations at http://en.flossmanuals.net/donate.
Sponsorship earns not only good “whuffie” but we’ll list your name or business name on these websites: FLOSS Manuals, JustWriteClick, Sugar Labs, and OLPC.
An exciting aspect of this BookSprint is the international effort behind it. Adam Hyde, founder of Floss Manuals, is planning to make the trek to Austin from Amsterdam, and there’s a French Floss Manuals coordinator working behind the scenes to ensure that the document can be translated to French. I’m also working with Yama Ploskonka, admin of the OLPC-Sur list of Spanish-speaking OLPC supporters to find Spanish language translators.
All in all, this is a very exciting effort and I’d love to get readers of JustWriteClick involved in any way you’d like. I’m very excited to be part of this effort and pleased to play host – let’s gather some more community around the BookSprint to make it a success.
Anne Gentle is the author of 
