Skip to content

Commit 8d36acd

Browse files
dennisdoomenDennis DoomenCopilot
authored
Add AV0115 guideline (#304)
Split from #298. Co-authored-by: Dennis Doomen <dennis.doomen@greenchoice.nl> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent 7c15003 commit 8d36acd

1 file changed

Lines changed: 14 additions & 0 deletions

File tree

_rules/0115.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
---
2+
rule_id: 0115
3+
rule_category: general
4+
title: Keep It Simple Stupid (KISS)
5+
severity: 1
6+
---
7+
The simplest solution that fully solves the problem is almost always the best one. Complexity accumulates quickly and makes code harder to read, test, debug and change.
8+
9+
Avoid:
10+
- Over-engineering for problems that don't yet exist.
11+
- Layers of abstraction that add no value in the current context.
12+
- Clever tricks that are hard to understand without deep knowledge of the language.
13+
14+
A method that a junior developer can read and understand in one pass is almost always preferable to an elegant but opaque alternative. Simplicity is a feature, not a shortcut.

0 commit comments

Comments
 (0)