aboutsummaryrefslogtreecommitdiff
path: root/contributing.md
diff options
context:
space:
mode:
Diffstat (limited to 'contributing.md')
-rw-r--r--contributing.md29
1 files changed, 29 insertions, 0 deletions
diff --git a/contributing.md b/contributing.md
new file mode 100644
index 0000000..c018917
--- /dev/null
+++ b/contributing.md
@@ -0,0 +1,29 @@
+# Contributing new code
+
+- Please do the following *before* sending a pull request:
+ - Merge upstream code (if any) back into your own branch
+ - Run formatters/linters
+
+# Git
+
+- TODO: tagging / versions
+- TODO: branch stability / gitflow?
+
+# Code style
+
+- Formatting nitty-gritty is handled by clang-format/clang-tidy
+- ASCII only
+- When using libraries of which the header include order is important, make
+ sure to separate the include statements using a blank line (clang-format may
+ sort include statements, but does not sort across empty lines).
+
+# Documentation
+
+- All documentation is written in U.S. English
+- TODO
+
+# Libraries
+
+- External libraries should be included as Git submodules under the `lib/`
+ subdirectory
+