Relative Content

Tag Archive for readability

Descriptive naming vs. 80 character lines [closed]

As it currently stands, this question is not a good fit for our Q&A format. We expect answers to be supported by facts, references, or expertise, but this question will likely solicit debate, arguments, polling, or extended discussion. If you feel that this question can be improved and possibly reopened, visit the help center for […]

Emphasize negation

I was just writing an if statement with fairly long property names and came occross this problem.

Java Generics – how to strike a balance between expressiveness and simplicity

I’m developing some code that utilizes generics, and one of my guiding principles was to make it usable for future scenarios, and not just today’s. However, several coworkers have expressed that I may have traded off readability for the sake of extensibility. I wanted to gather some feedback about possible ways to resolve this.

Is it correct to exclude argument names from function prototypes?

I was recently creating a small technical documentation for an application. The document is to be used by newly hired programmers to get acquainted with the application. It is much friendlier than the Javadocs we have, and includes information that usually isn’t being documented.