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