Difference between revisions of "Platform Developer Communication"
(Add notes on bugs.) |
(Change link to bug database) |
||
| (7 intermediate revisions by 3 users not shown) | |||
| Line 4: | Line 4: | ||
=== Mailing List === | === Mailing List === | ||
| − | The [http://groups.google.com/group/platformtalk Developer List] is open for all to join and our [http://groups.google.com/group/platformtalk/topics archives] are public. Use for discussion about the platform architecture, protocols, and implementations. Patch sets can also be sent to this list for review and application if you do not have | + | The [http://groups.google.com/group/platformtalk Developer List] is open for all to join and our [http://groups.google.com/group/platformtalk/topics archives] are public. Use for discussion about the platform architecture, protocols, and implementations. Patch sets can also be sent to this list for review and application if you do not have commit access. |
| + | |||
| + | The [http://groups.google.com/group/sirikata-commits sirikata-commits] list gets automated commit emails from the main Sirikata repository. | ||
=== IRC === | === IRC === | ||
| Line 14: | Line 16: | ||
=== Bugs === | === Bugs === | ||
| − | We have a [http:// | + | We have a [http://github.com/sirikata/sirikata/issues bug database] where we track bugs and feature requests. This is the best place to report bugs, although you may also want to email the [http://groups.google.com/group/platformtalk developer list] for particularly important bugs or feature requests, and especially for merge requests or patches. |
Carefully constructed bug reports and responses to requests for additional information or tests are crucial to getting bugs fixed. At a minimum, bug reports should include | Carefully constructed bug reports and responses to requests for additional information or tests are crucial to getting bugs fixed. At a minimum, bug reports should include | ||
| Line 21: | Line 23: | ||
* The features you have turned on and/or plugins you have loaded. | * The features you have turned on and/or plugins you have loaded. | ||
* A minimal test case if applicable, or a minimal set of steps needed to reproduce the problem. | * A minimal test case if applicable, or a minimal set of steps needed to reproduce the problem. | ||
| + | * A backtrace if you are reporting a crash and can obtain one. | ||
We appreciate your attention to detail. | We appreciate your attention to detail. | ||
| − | |||
| − | |||
| − | |||
| − | |||
Latest revision as of 23:00, 21 July 2011
Developers stay in touch via a number of mechanisms
Mailing List
The Developer List is open for all to join and our archives are public. Use for discussion about the platform architecture, protocols, and implementations. Patch sets can also be sent to this list for review and application if you do not have commit access.
The sirikata-commits list gets automated commit emails from the main Sirikata repository.
IRC
Our IRC channel is #sirikata on irc.freenode.net and we keep open logs. This is used for real time discussion with developers - quick questions, detailed questions about code, etc.
If you have never used IRC then the Wikipedia article on IRC gives a good overview
Bugs
We have a bug database where we track bugs and feature requests. This is the best place to report bugs, although you may also want to email the developer list for particularly important bugs or feature requests, and especially for merge requests or patches.
Carefully constructed bug reports and responses to requests for additional information or tests are crucial to getting bugs fixed. At a minimum, bug reports should include
- The version or revision number which the bug was discovered on. Bonus points if you can track down the revision that introduced the problem.
- The platform you are working on.
- The features you have turned on and/or plugins you have loaded.
- A minimal test case if applicable, or a minimal set of steps needed to reproduce the problem.
- A backtrace if you are reporting a crash and can obtain one.
We appreciate your attention to detail.