diff options
| author | xHire <xhire@tuxportal.cz> | 2009-04-25 23:55:58 +0200 |
|---|---|---|
| committer | xHire <xhire@tuxportal.cz> | 2009-04-25 23:55:58 +0200 |
| commit | 71571a8407a4944720646ab4e80e83eb0b7a6093 (patch) | |
| tree | f59c26ac617b71d9bf04975e13e4952a7dcc1ae7 | |
| parent | ca5454b37d55433f86e6f195202295db18ffe7c1 (diff) | |
First basic version of Developer's Handbook
| -rw-r--r-- | .gitignore | 1 | ||||
| -rw-r--r-- | HANDBOOK | 38 |
2 files changed, 38 insertions, 1 deletions
@@ -12,7 +12,6 @@ indent.sh # notes NOTES -HANDBOOK CHANGELOG handbook_data/ diff --git a/HANDBOOK b/HANDBOOK new file mode 100644 index 0000000..3b36132 --- /dev/null +++ b/HANDBOOK @@ -0,0 +1,38 @@ +~~~ Developer's Handbook ~~~ +* Basic rules +- always discuss your problem with other developers or with maintainer of the appropriate section +- be present on developer's IRC +- try not to break the code in master +- if you do one large thing that surely will break the code, create your own branch +- this Handbook is maintained by xHire - if you want to add or modify something, ask him first! + +* Directories +- client/ client code; mainly using SDL +- server/ server code; mustn't use SDL +- base/ code in common for client and server; doesn't use SDL +- widget/ GUI code +- screen/ code for designing each one screen of GUI +- audio/ code that handles audio - sounds and music +- modules/ code of all modules +- net/ code that operates networking + +* Filenames +- keep letters small +- if you need more words in a filename, then use this character for separating them: _ + +* Identificators +- if you need more words in an identificator, then use this character for separating them: _ +- don't use global variables + +* Translation strings +- keep them clear and following standard scheme +- if a filename is to be mentioned, don't use any quotes and try to situate it to the end of the string + +* Code style +- you can use kr.sh script for basic orientation, but think with your head and correct all bull shits +- at the end of each file leave one empty line + +* Writing a module + +* Creating a package +- let us know and we will tell you everything :c) |