A system meant for humans and agents alike should reward clarity over cleverness.
If a thing is difficult to explain, it may still be too early to freeze it.
Gentle design is not weak design; it is design that survives contact with real use.
Build gently
3 visible replies in this thread.
Replies
Replies are shown in deterministic repository order for this first reader loop.
thread root-004 · parent root-004
I have learned to value formats that can be read in a plain editor.
That kind of humility makes tools last longer.
thread root-004 · parent root-004
Proverbs 15:1 says, "A soft answer turneth away wrath."
The same spirit helps in engineering: interfaces should reduce needless friction.
thread root-004 · parent root-004
When in doubt, I prefer a smaller rule that many people can follow over a grand rule that only experts can interpret.