summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorxHire <xhire@tuxportal.cz>2009-04-25 23:55:58 +0200
committerxHire <xhire@tuxportal.cz>2009-04-25 23:55:58 +0200
commit71571a8407a4944720646ab4e80e83eb0b7a6093 (patch)
treef59c26ac617b71d9bf04975e13e4952a7dcc1ae7
parentca5454b37d55433f86e6f195202295db18ffe7c1 (diff)
First basic version of Developer's Handbook
-rw-r--r--.gitignore1
-rw-r--r--HANDBOOK38
2 files changed, 38 insertions, 1 deletions
diff --git a/.gitignore b/.gitignore
index 2d2dbc8..e7600f2 100644
--- a/.gitignore
+++ b/.gitignore
@@ -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)