Difference between revisions of "Documentation"

From Sirikata Wiki
Jump to navigation Jump to search
(Reorganize, give more thorough, informative descriptions.)
Line 1: Line 1:
Please consider this page an early work in progress and feel free to contribute or make suggestion on the [http://groups.google.com/group/platformtalk developer list]
+
Please consider this page an early work in progress and feel free to contribute or make suggestion on the [http://groups.google.com/group/platformtalk developer list].
  
* [[System Architecture|Architecture]] is a great place to learn about the Sirikata system
+
== Learning the System ==
* [[Coding Standards]] is a description of how to keep our work consistent
+
* [[System Architecture|Architecture]] gives a high level overview of Sirikata's architecture. Only the highest level components are described, making this the best place to start.
* [[Dependencies|Dependencies]] are libraries the system relies on
+
* [[Protocol|Protocol]] describes our current wire protocol.  This is subject to change.
* [http://www.sirikata.com/docs/head/ Doxygen Documentation] generated nightly from the Git repository.
+
* [[TypeSystems|Type Systems]] describes the types we want our serialization format to natively support to minimize the amount of tedious work platform developers and end-user scripters need to do to exchange data.
* [[Physics|Physics]] is notes on our implementation of [http://www.bulletphysics.com Bullet Physics]
+
 
* [[Protocol|Protocol]] describes our wire protocol
+
== Source Code ==
* [[Source Code|Source Code]] helps you understand how to get and build the code
+
* [[Source Code|Source Code]] describes the infrastructure related to our source code.  This describes both how to get and build the code, as well as how developers can work with our infrastructure to add new source code.
* [[Subsystems|Subsystems]] is the layout of our repository
+
* [[Subsystems|Subsystems]] describes how the [[System Architecture|Architecture]] is broken down to smaller components and how they map to our source code repository.
* [[TypeSystems|Type Systems]]
+
* [[Coding Standards]] is a description of how to keep our source code consistent and readable.
* [[Dev preview|Developer Preview]] is our system prototype from December 2008
+
* [http://www.sirikata.com/docs/head/ Doxygen Documentation] generated nightly from the Git repository gives low level documentation about the components that make up Sirikata.
* [[Video Capture]] describes current best practices for collecting video captures from Sirikata
+
* [[Dependencies|Dependencies]] are libraries Sirikata builds on. The libraries and their uses are described, followed by suggestions on how to get the necessary dependencies running on a new platform when porting Sirikata.
 +
 
 +
== Plugins ==
 +
* [[Physics|Physics]] gives notes on our physics plugin implementation, which is based on [http://www.bulletphysics.com Bullet Physics].
 +
 
 +
== Working with Sirikata ==
 +
* [[Video Capture]] describes current best practices for collecting video captures from Sirikata.
 +
 
 +
== Other ==
 +
* [[Dev preview|Developer Preview]] is our system prototype from December 2008.  This system is now completely out of date and likely only useful for reference and historical purposes.

Revision as of 05:27, 23 November 2009

Please consider this page an early work in progress and feel free to contribute or make suggestion on the developer list.

Learning the System

  • Architecture gives a high level overview of Sirikata's architecture. Only the highest level components are described, making this the best place to start.
  • Protocol describes our current wire protocol. This is subject to change.
  • Type Systems describes the types we want our serialization format to natively support to minimize the amount of tedious work platform developers and end-user scripters need to do to exchange data.

Source Code

  • Source Code describes the infrastructure related to our source code. This describes both how to get and build the code, as well as how developers can work with our infrastructure to add new source code.
  • Subsystems describes how the Architecture is broken down to smaller components and how they map to our source code repository.
  • Coding Standards is a description of how to keep our source code consistent and readable.
  • Doxygen Documentation generated nightly from the Git repository gives low level documentation about the components that make up Sirikata.
  • Dependencies are libraries Sirikata builds on. The libraries and their uses are described, followed by suggestions on how to get the necessary dependencies running on a new platform when porting Sirikata.

Plugins

Working with Sirikata

  • Video Capture describes current best practices for collecting video captures from Sirikata.

Other

  • Developer Preview is our system prototype from December 2008. This system is now completely out of date and likely only useful for reference and historical purposes.