summaryrefslogtreecommitdiffstats
path: root/STYLE
blob: f1256a6e265966f4138bc23713c58c28c35c94b5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

== Coding guidelines for contributing to
== xmonad and the xmonad contributed extensions

* Comment every top level function (particularly exported funtions), and 
  provide a type signature; use Haddock syntax in the comments.

* Follow the coding style of the other modules.

* Code should be compilable with -Wall -Werror. There should be no warnings.

* Partial functions should be avoided: the window manager should not
  crash, so do not call `error` or `undefined`

* Tabs are illegal. Use 4 spaces for indenting.

* Any pure function added to the core should have QuickCheck properties
  precisely defining its behaviour.

* New modules should identify the author, and be submitted under
  the same license as xmonad (BSD3 license or freer).