James Moorhouse
Sep 3, 2018 · 1 min read

Code readability should come before premature optimisation.

The problem with shortening names like this is that every time a developer reads that word they have to think about and decide what it actually is.

Sure doc means document, but is this the global document? a doc local to the current code? it’s a trivial task to work out, but why should developers have to do that? far easier to read the code when it’s explicit.

If you’re using a good IDE then the argument about typing out the full name is irrelevant

    James Moorhouse

    Written by