Difference between revisions of "Documentation Team/Book Sprint"

Latest revision as of 20:15, 24 February 2010

Team Home · Join · Contacts · Resources · FAQ · Roadmap · To Do · Meetings

We are planning a book sprint this fall for create a user's guide for Sugar. Please add add you comment and concerns here or on the discussion page.

Location

Austin, Texas

Anne investigating

Date

25–29 August 2008

Scope of documentation for sprint

Audience: Basic Users Guide. Advanced Guide will follow after the Sprint

Draft Outline

Getting Started Guide for the file system, wireless connections, everything you do without Activities. Walter Bender has started with User:Walter/sandbox, which points out where the Floss Manual can be updated to be hardware-free (for example, his annotations with OLPC-XO-1-specific hints for keyboard shortcuts and specifics for the OLPC-XO-1 hardware). Updates should be made to http://en.flossmanuals.net/olpc_simple.

Getting Started with an Activity for specific Activities, such as Browse and Record. A starter manual for the Record activity can be found at http://en.flossmanuals.net/olpc_record. Priorities needed for which Activities to start first.

Recruited/invited writers (expect about 5-6 in person)

Austin, Texas: Anne Gentle; David Cramer; Janet Swisher

Boston, Ma: Seth Woodworth; Walter Bender

Illinois (Chicago area): Mel Chua; Emily Kaplan

Other locations: Adam Hyde - Netherlands; David Farning - Wisconsin; Greg DeKoenigsberg - Raleigh NC; Robert Nagle - Houston; Ron Hale-Evans - Seattle

Vision

Create a users manual for Sugar.

Road Map

Below is a rough draft of a project schedule.

Week 1 - Target Date July 13. Define scope of document. Assign volunteers to specific tasks.
Week 3 - Target Date July 27. Deadline for outlines of chapters to be worked on at sprint.
Week 5 - Target Date Aug 25. Conduct sprint.
Week 6 - Editing and Translation Begins

The rest is based on the chosen release date for the spring release of Sugar.

Week 0 - Release Final documentation
Week -1 Final translation tarballs due
Week -4 Documentation freeze
Week -5 Book Sprint II

...

@@ Line 1: / Line 1: @@
-<noinclude>{{ GoogleTrans-en | es =show | bg =show | zh-CN =show | zh-TW =show | hr =show | cs =show | da =show | nl =show | fi =show | fr =show | de =show | el =show | hi =show | it =show | ja =show | ko =show | no =show | pl =show | pt =show | ro =show | ru =show | sv =show }}{{TeamHeader|DocumentationTeam}}</noinclude>
+<noinclude>{{ GoogleTrans-en | es =show | bg =show | zh-CN =show | zh-TW =show | hr =show | cs =show | da =show | nl =show | fi =show | fr =show | de =show | el =show | hi =show | it =show | ja =show | ko =show | no =show | pl =show | pt =show | ro =show | ru =show | sv =show }}{{TeamHeader|Documentation Team}}</noinclude>
+{{TOCright}}
 We are planning a book sprint this fall for create a user's guide for Sugar.  Please add add you comment and concerns here or on the discussion page.
 == Location ==
-OLPC offices (Boston)
+:Austin, Texas
-yet unknown, Anne investigating (Austin)
+:Anne investigating
 == Date ==
-late August (tentative proposal 16-23)
+–29 August 2008
 == Scope of documentation for sprint ==
-Audience: kids, parents, and teachers. End-users, basically.
+Audience: Basic Users Guide. Advanced Guide will follow after the Sprint
+Draft [[Documentation Team/Book Sprint/Outline|Outline]]
 Getting Started Guide for the file system, wireless connections, everything you do without Activities.
-Walter Bender has started with [User:Walter/sandbox], which points out where the Floss Manual can be updated to be hardware-free (for example, his annotations with OLPC-XO-1-specific hints for keyboard shortcuts and specifics for the OLPC-XO-1 hardware). Updates should be made to http://en.flossmanuals.net/olpc_simple.
+Walter Bender has started with [[User:Walter/sandbox]], which points out where the Floss Manual can be updated to be hardware-free (for example, his annotations with OLPC-XO-1-specific hints for keyboard shortcuts and specifics for the OLPC-XO-1 hardware). Updates should be made to http://en.flossmanuals.net/olpc_simple.
 Getting Started with an Activity for specific Activities, such as Browse and Record.
@@ Line 20: / Line 22: @@
 == Recruited/invited writers (expect about 5-6 in person) ==
-Anne Gentle - Austin, Texas
+;Austin, Texas
-Adam Hyde  - Netherlands
+:Anne Gentle
-David Farning - Wisconsin
+:David Cramer
-Walter Bender - East coast
+:Janet Swisher
-Greg DeKoenigsberg - Raleigh NC
-Emily Kaplan - Illinois (Chicago area)
+;Boston, Ma
-Robert Nagle - Houston
+:[[User:Seth|Seth Woodworth]]
-Janet Swisher - Austin
+:Walter Bender
-David Cramer - Austin
+;Illinois (Chicago area)
+:Mel Chua
+:Emily Kaplan
+;Other locations
+:Adam Hyde  - Netherlands
+:David Farning - Wisconsin
+:Greg DeKoenigsberg - Raleigh NC
+:Robert Nagle - Houston
+:Ron Hale-Evans - Seattle
+== Vision ==
+Create a users manual for Sugar.
+== Road Map ==
+Below is a rough draft of a project schedule.
+*Week 1 - Target Date July 13. Define scope of document. Assign volunteers to specific tasks.
+*Week 3 - Target Date July 27. Deadline for outlines of chapters to be worked on at sprint.
+*Week 5 - Target Date Aug 25. Conduct sprint.
+*Week 6 - Editing and Translation Begins
+The rest is based on the chosen release date for the spring release of Sugar.
+*Week 0 - Release Final documentation
+*Week -1 Final translation tarballs due
+*Week -4 Documentation freeze
+*Week -5 Book Sprint II
+...