You learn lots of things when you go to college and get a computer science degree or read a how-to-program book. Unfortunately, a number of good programming habits are either untaught or take a good amount of practice to turn into a way of life. Here are 10 such habits you should cultivate to become a better programmer.
1: Learn your source control process
You know that thing users like to do, where they pick up your application for the first time and get angry because it doesn't do things exactly the way they want — and then they refuse to learn how the program works? You're left scratching your head wondering why they didn't bother to learn the application, which would have saved them all sorts of problems.
Well, a lot of developers do that too, when it comes to working with source control. Every source control system is a bit different and has a workflow that maximizes the value you get from it. Learn that workflow! It may take some time, research, and practice, but trying to fight it by making your source control repository look like the ugly mess you are used to creating on your local hard drive defeats the purpose. You might as well just have good backups for your local system and call it a day.
2: Go with obvious variable naming
This one comes up all the time: developers just give variables uninformative names and think it doesn't matter. Well, it does matter any time someone else comes in to look at the code. I can't speak for all developers, but I have yet to meet one who is typing for eight hours a day straight. Adding a few keystrokes for better variable names (especially when modern IDEs will autofill it for you) will make a measurable different in productivity. Stop making excuses and use better variable names.
3: Use interfaces, not classes when possible
I violate this one all the time, and I know it. Whenever possible, code to an interface instead of a class. For example, if your class needs to return an enumeration of Integers, there's no need to return a List<int>; return an IEnumerable<int>. This allows recipients to do what they want without needing to recast or transform the results into a class that meets their needs.
4: Assume the worst from your peers
I'd love to think that everyone I worked with was as good, if not better than me at writing software. In some jobs, it was usually true; but in others, it wasn't. I did learn, though, that you have to write your code as if someone with six months of experience (or someone with lots of experience who just is not very good) is going to be working on it next, because it may very well be true. What that means is that you can't afford to write "fancy" or excessively "elegant" code. The next person to look at it could end up making a mess because he or she doesn't understand it. I've discovered that writing code is like cooking: To please everyone, you can't go for the escargot or liver pate; you need to be serving steak and potatoes. Keep your code basic and straightforward, and those coming behind you to maintain it will be able to do their job.
5: Assume the worst from your users
There is a bell curve of tech savvy with our users. We tend to miss the mark on usability and hit the lower end of the bell, but that still leaves about 10% - 20% of users in the dark. Aiming for the lowest common denominator means just that. With a few exceptions, you have to assume that the person using your application will never look at documentation, attend training, or otherwise seek out how to use your application.
6: Document the reason for a change
All too often, there will be a change in an application but no documentation of why the change was made. A few months later, someone will notice that the change conflicts with another requirement and demand to know why it was made, and no one will actually know. The next thing you know, everyone will be losing a lot of time trying to figure out where the change came from and why. By documenting the purpose of the change (and who the requester is), you'll be saving everyone a big headache down the road.
7: Explain the purpose of algorithms
In the same vein, any algorithm should have a clear explanation of why it was chosen. For example, I support a CRM system that has a nonintuitive formula for applying discounts to purchases. No one can quite explain why this specific formula is in place, but it is not working in some scenarios. We are not quite sure how to change it, because the reason for its current form is unknown. All it would have taken was a simple comment that said, "We do it like this because of consideration CYZ," and everything would be fine.
8: Provide contextual help
We all know that users tend to gloss over training materials. At the same time, it's important to provide a variety of contextually available help in your application. While users won't read the manual, they are likely to click the giant question mark next to the input control they don't understand. Put your help access as close to the UI controls as possible with targeted text to make it easy for users to get the help they need. Also, remember to use terms and phrases your users will understand, not internal jargon.
9: Perform cross-platform testing
If you are writing Web applications, it is important to test them on a variety of platforms. You will want to check different browsers on different platforms. Sounds like a hassle, right? It is. Luckily, there are some tools to help with that. Check out the offerings from Sauce Labs to make it a bit easier to cross-platform test your Web applications.
10: Keep the users in mind
A lot of business requirements don't help the users at all, and some may even annoy them. These requirements may be non-functional but are designed to satisfy someone in the marketing or sales departments. A great example is a registration page that asks for a lot more information (and makes it mandatory) than most users feel comfortable giving. While I understand the motivation (making their jobs easier), developers often underestimate how much users dislike it —while overestimating users' desire to get the benefits of registration. Remember that there are few unique propositions in this industry, and you do not have the luxury of turning users away. Fight on behalf of your users to make the best application possible.
What would you add?
What other good practices do you think are underused? Do you have any pet peeves you'd add to this list?
Justin James is an OutSystems MVP, architect, and developer with expertise in SaaS applications and enterprise applications.