Skip to content

stevegrossi

programming

Tended 3 years ago Planted 3 years ago Mentioned 4 times

Contents

Programming is the act of communicating your intentions and understanding of a system to other people in a way that happens also to make them a reality within that system.

Some of My Programming Principles

Code is for people.

Sure, computers run our code, but if they were its primary audience we’d just write everything in binary. Code is fundamentally exposition: descriptions of systems, their domains, and behavior. As we come to rely ever more on these systems and they grow increasingly complex, the need for human-intelligible code has never been greater.

Websites are for people.

Never forget that the people visiting our websites are not captive audiences. They have goals to accomplish, and in nearly all cases, better things to do. We must learn (and continue learning) who they are and what they need, and get them to it as quickly and easily as possible, wherever and however they may be.

Write less code.

Writing code is easy. One of the most valuable lessons of experience is knowing the code you don’t have to write. Don’t repeat yourself. Do more with less. This applies just as well to others’ code we use in our projects as it does to our own.

Small is beautiful.

But even more importantly, it’s understandable. Break big things up into smaller parts: ideally each part should do exactly one thing. Our job is to manage complexity, not add to it.

Tests Are More Important than Code

On any long-lived project, your code will change constantly. Tests are proof that your system does what it needs to, and are far more valuable over time than the particular way in which it performs a given task, which will change.

Mentions

  • about

    …and ideas on the things I'm interested in, mainly [[programming]], [[philosophy]], and [[systems thinking|systems thinking]], especially related to [[systems…

  • Code reviews

    …reviews are a form of [[giving feedback|peer feedback]] for [[programming|programmers]]. Insights from [a study by SmartBear](https://smartbear.com…

  • flow

    …to follow this pattern and are thus flow state generators. [[Programming]] too is marked by this continual series of challenges ("I…