Documentation
|
Size: 2256
Comment: this is a devel page therefore name is redundant
|
Size: 2266
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 6: | Line 6: |
| A new suggestion has been made to use ''Recipes'', much like the [:MOTU/Recipes:MOTU recipes]. The idea being that Edubuntu members can be asked to write a ''recipe'' for practically anything, e.g.: | A new suggestion has been made to use ''Recipes'', much like the [:PackagingGuide/Recipes:MOTU recipes]. The idea being that Edubuntu members can be asked to write a ''recipe'' for practically anything, e.g.: |
This is the planning page for Edubuntu documentation, both content and procedures.
Planning
A new suggestion has been made to use Recipes, much like the [:PackagingGuide/Recipes:MOTU recipes]. The idea being that Edubuntu members can be asked to write a recipe for practically anything, e.g.:
- recording their Edubuntu lab setup
- best practices
- notes on using a piece of software
- LTSP setup
- applicability of FLOSS for education
This is being seen as the best way to capture user documentation and feedback for the handbook, help wiki, yelp (TBH) etc.
There are a number of options for using and presenting this information. We need to decide on a procedure.
Option 1
recipes are captured on the wiki: https://help.ubuntu.com/community/EdubuntuRecipes
static page of links to recipes provided off http://www.edubuntu.org
- the handbook skims information from this doc set
- Handbook and html version of wiki recipes are packaged and shipped in edubuntu-docs
Option 2
recipes are captured on the wiki: https://help.ubuntu.com/community/EdubuntuRecipes
static page of links to recipes provided off http://www.edubuntu.org
- recipes are incorporated into the TBH system for yelp
- the handbook skims information from this doc set
- TBH and Handbook are packaged and shipped in edubuntu-docs
Option 3
recipes are captured on the wiki: https://help.ubuntu.com/community/EdubuntuRecipes
static page of links to recipes provided off http://www.edubuntu.org
- Handbook becomes collection of TBH recipes for yelp
LTSP Docs
LTSP is not Edubuntu specific, it pertains to Ubuntu as well.
An LTSP section should be made for TBH in Ubuntu. Edubuntu specific LTSP options can then either appear in the Handbook or in the Handbook and Edubuntu TBH sections (depending on recipe planning procedure)
FAQ
https://help.ubuntu.com/community/EdubuntuFAQ is for capturing common questions out of the mailing lists and IRC channels. It is mainly a reference for short answers to common questions but can be used for skimming information into other formal documents.
Edubuntu/Documentation (last edited 2009-10-14 19:19:50 by 95)