this repo has no description
📚 Enhance programming guidelines with new insights on simplicity and communication
+2
-1
+2
-1
Programming.md
+2
-1
Programming.md
···
9
9
- **Design for simplicity**.
10
10
- Do the [simplest thing](https://landing.google.com/sre/book/chapters/simplicity.html) that could possibly work.
11
11
- Benefits of simplicity: ease of understanding, ease of change (improvement), ease of debugging, flexibility. [The goal of software design is to create chunks or slices that fit into a human mind](https://mobile.twitter.com/KentBeck/status/1354418068869398538). The software keeps growing but the human mind maxes out, so we have to keep chunking and slicing differently if we want to keep making changes.
12
+
- Break down complex problems into simpler, digestible pieces. If you do it right, it will feel like cheating: you just solve simple problems until you're done.
12
13
- We can't change our brain to grasp something complex. We need to simplify complexity so we can handle it.
13
14
- Eliminate state. If you can't, make it visible.
14
15
- Design is an iterative process. The necessary number of iterations is one more than the number you have currently done. This is true at any point in time.
···
41
42
- **A programmer who can't re-use other programs is condemned to re-write them**.
42
43
- Use software leverage to your advantage.
43
44
- Many programmers have only a superficial understanding of the importance of re-usable code modules.
44
-
- [Code isn't just meant to be executed. Code is also a means of [[Communication]] across a team, a way to describe to others the solution to a problem](https://medium.com/s/story/notes-to-myself-on-software-engineering-c890f16f4e4d).
45
+
- [Code isn't just meant to be executed. Code is also a means of [[Communication]] across a team, a way to describe to others the solution to a problem](https://medium.com/s/story/notes-to-myself-on-software-engineering-c890f16f4e4d). Good writing skills often correlate with good thinking and programming skills. [Sharing knowledge through writing (blogs, talks, documentation, open source) clarifies your thinking and helps others](https://endler.dev/2025/best-programmers/).
45
46
- **Silence is golden**.
46
47
- A silent command is often more usable, providing the function asked for and nothing more.
47
48
- **Think parallel**.