2 files changed, 35 insertions, 1 deletions

diff --git a/doc/topics/code-style.txt b/doc/topics/code-style.txt
new file mode 100644
index 0000000..45318ab
--- /dev/null
+++ b/doc/topics/code-style.txt
@@ -0,0 +1,34 @@
+Title: Code style
+
+
+About: Source formatting
+
+- C sources must be properly indented using two spaces per nesting level.
+- Opening braces are put on the same line as there prelude statement and may be omitted consistently per block.
+- Booleans from `stdbool` are preferred to binary integer values.
+- Inside comparisons, the constant part should be on the right.
+- Pointer declaration must be put adjacent to the declared identifier, not to the type.
+
+In brief, a function should look like so:
+
+> char *f(char *c) {
+>   if (c % 2 == 0)
+>     return 1;
+>   else if (c == 1)
+>     return 2;
+>   else
+>     return 3;
+> }
+
+
+About: Code structure
+
+- Variables are declared at the top of a context.
+- It is advised to declare variables on the stack instead of the heap when possible.
+- The use of `assert` is encouraged.
+- The use of `static` functions is encouraged. Such members must be declared prior to others.
+
+
+About: Unit tests
+
+- Unit test files have the `.test.c` extension.
diff --git a/makefile b/makefile
index 7e09eeb..83f52fb 100644
--- a/makefile
+++ b/makefile
@@ -1,6 +1,6 @@
 api-doc:
         $(eval TMPDIR := $(shell mktemp -d))
-        naturaldocs --project $(TMPDIR) --input include/ --output HTML doc/api/
+        naturaldocs --project $(TMPDIR) --input include/ --input doc/topics/ --output HTML doc/api/
         $(RM) -r $(TMPDIR)
 
 report: