The Holy Java

Building the right thing, building it right, fast

Archive for March, 2016

It Is OK to Require Your Team-mates to Have Particular Domain/Technical Knowledge

Posted by Jakub Holý on March 6, 2016

Should we write stupid code that is easy to understand for newcomers? It seems as a good thing to do. But it is the wrong thing to optimise for because it is a rare case. Most of the time you will be working with people experienced in the code base. And if there is a new member, you should not just throw her into the water and expect her to learn and understand everything on her own. It is better to optimise for the common case, i.e. people that are up to speed. It is thus OK to expect and require that the developers have certain domain and technical knowledge. And spend resources to ensure that is the case with new members. Simply put, you should not dumb down your code to match the common knowledge but elevate new team mates to the baseline that you defined for your product (based on your domain, the expected level of experience and dedication etc.).

Read the rest of this entry »

Advertisements

Posted in SW development | Tagged: | Comments Off on It Is OK to Require Your Team-mates to Have Particular Domain/Technical Knowledge

Don’t add unnecessary checks to your code, pretty please!

Posted by Jakub Holý on March 4, 2016

Defensive programming suggests that we should add various checks to our code to ensure the presence and proper shape and type of data. But there is one important rule – only add a check if you know that thing can really happen. Don’t add random checks just to be sure – because you are misleading the next developer.

Read the rest of this entry »

Posted in SW development | Tagged: , | 1 Comment »