aboutsummaryrefslogtreecommitdiff
path: root/contributing.md
diff options
context:
space:
mode:
authorLoek Le Blansch <loek@pipeframe.xyz>2024-10-10 07:04:27 +0200
committerLoek Le Blansch <loek@pipeframe.xyz>2024-10-10 07:04:27 +0200
commit29fb4bda4872bdfe33a2416a239fb62fc0238167 (patch)
tree367f8b32fc843b481b42dff54adfd0939afeb0b7 /contributing.md
parent08d0b07c19edfe8c81dfe4e21c0d4c1ef128b628 (diff)
parentdcfb674ccdf48a7fd78c98644e5b3b826c399206 (diff)
merge `loek/scripts` into `master`
Diffstat (limited to 'contributing.md')
-rw-r--r--contributing.md8
1 files changed, 8 insertions, 0 deletions
diff --git a/contributing.md b/contributing.md
index 9f87ec5..364e835 100644
--- a/contributing.md
+++ b/contributing.md
@@ -17,6 +17,12 @@
# Code style
- ASCII only
+- Class names are always singular
+- Explanatory comments are placed above the line(s) they are explaining
+- Source files should only contain comments that plainly state what the code is
+ supposed to do
+- Explanatory comments in headers may be used to clarify implementation design
+ decisions
- Formatting nitty-gritty is handled by clang-format/clang-tidy (run `make
format` in the root folder of this repository to format all sources files)
- When using libraries of which the header include order is important, make
@@ -51,6 +57,8 @@
```
- Member variable default values should be directly defined in the class
declaration instead of using the constructor.
+- Header files declare either a single class or symbols within a single
+ namespace.
## CMakeLists specific