summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--BUILDING.md18
1 files changed, 18 insertions, 0 deletions
diff --git a/BUILDING.md b/BUILDING.md
index 10d7d8f4a..4738d1350 100644
--- a/BUILDING.md
+++ b/BUILDING.md
@@ -85,3 +85,21 @@ Example:
If your port/build includes `arm-none-eabi-gdb-py`, consider using it instead, as it can be used for better register
debugging with https://github.com/bnahill/PyCortexMDebug
+
+# Code Quality Checks
+
+We apply code quality checks using pre-commit. Install pre-commit once per system with
+
+ python3 -mpip install pre-commit
+
+Activate it once per git clone with
+
+ pre-commit --install
+
+Pre-commit also requires some additional programs to be installed through your package manager:
+
+ * Standard Unix tools such as make, find, etc
+ * The gettext package, any modern version
+ * uncrustify version 0.71 (0.72 is also tested)
+
+Some pre-commit quality checks require your active attention to resolve, others (such as the formatting checks of uncrustify) are made automatically and must simply be incorporated into your code changes by committing them.