Difference between revisions of "Documentation Team"

From Sugar Labs
Jump to navigation Jump to search
Line 4: Line 4:
 
* Probably we should document the datastore dbus API. I'm not sure what's the best way to generate documentation for it. It's so small that a wiki page might be the simpler solution for now.
 
* Probably we should document the datastore dbus API. I'm not sure what's the best way to generate documentation for it. It's so small that a wiki page might be the simpler solution for now.
 
* Collaboration API. I have no idea, morgs we need your help here.
 
* Collaboration API. I have no idea, morgs we need your help here.
 +
:* Existing collaboration documentation is at [http://wiki.laptop.org/go/Category:Collaboration] --[[User:Morgs|Morgs]] 19:59, 15 May 2008 (UTC)
 
* Low level API (non-python activities). We should just move bert document on this wiki.
 
* Low level API (non-python activities). We should just move bert document on this wiki.
  

Revision as of 15:59, 15 May 2008

API documentation

  • sugar-base and sugar-toolkit has API documentation in the code. What tool do we use to generate html? Where do we generate it and where we make it available? Do we need to build them to generate docs?
  • Probably we should document the datastore dbus API. I'm not sure what's the best way to generate documentation for it. It's so small that a wiki page might be the simpler solution for now.
  • Collaboration API. I have no idea, morgs we need your help here.
  • Existing collaboration documentation is at [1] --Morgs 19:59, 15 May 2008 (UTC)
  • Low level API (non-python activities). We should just move bert document on this wiki.

Manual

  • Setup a development environment. This is wiki oriented so we should probably not even mention jhbuild (we should definately not do so until we have a bunch of autobuild slaves running).
  • "Write your activity" tutorial. It should include all the important bits: graphic controls, datastore, collaboration
  • Probably good to have a pygame tutorial, it's probably the best thing we have at the moment to do free form graphics stuff.
  • Etoys based activity tutorial?

Community