Configuration Reference¶
.clang-format.yml¶
C/C++ formatting rules consumed by clang-format.
Key settings:
| Setting | Value | Rationale |
|---|---|---|
IndentWidth |
Configurable | Set to match your project's convention |
ColumnLimit |
120 | Wide enough for descriptive names |
PointerAlignment |
Right (int *p) |
Common in embedded/systems code |
SortIncludes |
true | Deterministic include order |
.clang-tidy¶
C/C++ static analysis checks. Runs as part of lint in pre-commit.
ruff.toml¶
Python linting and formatting configuration.
| Setting | Value | Rationale |
|---|---|---|
line-length |
132 | Readable on modern screens |
target-version |
Configurable | Set to your minimum Python version |
quote-style |
double | Consistency |
indent-style |
space | Standard Python |
.shellcheckrc¶
Shell script analysis severity and rule exclusions.
.yamllint.yml¶
YAML validation rules (indentation, line length, truthy values).
.editorconfig¶
Cross-IDE formatting consistency. Defines indent style/size per language.
config/hooks.json¶
Master configuration for all git hooks. See docs/index.md for full field reference.
config/license-templates.json¶
Organization-specific license header templates. Fields:
| Field | Description |
|---|---|
enabled |
Toggle header enforcement on/off |
mode |
spdx for SPDX-style headers |
copyright_holder |
Your organization name |
copyright_year |
auto uses current year |
spdx_identifier |
License identifier (e.g., Apache-2.0, MIT) |