The discoveries you make in the making Style is an expression of the interest you take in the making of every sentence. It emerges, almost without intent, from your engagement with each sentence. It's the discoveries you make in the making of the prose itself. Where ambiguity rules, there is no "style"—or anything else worth having. Pursue clarity instead. In the pursuit of clarity, style reveals itself. Verlyn Klinkenborg, Several Short Sentences About Writing The idea grows as they workFour principlesExpressing ideas helps to form them styleclaritymaking
Simple moments of clarity I have seen autistic children drawing at a terrific speed and I've always thought that my drawings should not be less rapid, because that speed gives them insignificance. In this speed lies their abandonment and it may cause them to be overlooked as mere doodles. However, I understand that they are like that pristine light that appears when they tell you that you have a tumour. In an instant, everything becomes clear and well-defined. All contours are cruelly illuminated as if it was worth taking a final look at the world. At such times, although the lines in the drawings clump into a skein of events that are indecipherable to ordinary mortals, they can be described in detail by the victim one by one. These are moments when weeds regain their nature as plants. Only now can I understand these drawings as simple moments of clarity. Smiljan Radić, Death at Home artclarity
Pellucidity A Definition www.thefreedictionary.com Free from obscurity and easy to understand; the comprehensibility of clear expression euphonyunderstandingthinkingclarity
Deadlines are bullshit An Article contrariantruth.substack.com In software development deadlines are a necessary evil. It is important to understand when they are necessary, and it is important to understand why they are evil. External vs. internal deadlinesWhy are internal deadlines evil?Engineers who love their work Hofstadter's LawThe Thing-deadline calculusNever enough timeDriving engineers to an arbitrary date is a value destroying mistake bureaucracysoftwareprocesswork
External vs. internal deadlines When are deadlines necessary? Contractual obligations Technical liabilities (e.g., dependency EOL) Compliance, government, investors, and other external stakeholders What do all of these deadlines have in common? They are all important. They are all deadlines that cannot be missed. They are all external. When are deadlines evil? Your manager says you have a deadline Your software development methodology says you have deadlines What do all of these deadlines have in common? None of them are important. They are arbitrary. They are all internal. They are all bullshit.
Why are internal deadlines evil? Estimation: When estimating engineering work a substantial time investment is required by an engineer in order to get an accurate estimate. Misaligned Incentives: There is an incentive to lie and give estimates much longer than the feature is truly expected to take. Low Morale: Deadlines are likely to be missed often. Repeated failure has a cost to the morale of the team. Micromanagement: Deadlines are wielded by middle managers as a whip to harass and annoy engineers working on features. High Stress: When engineers feel the pressure of other stakeholders holding deadlines over their heads it creates an environment of high stress. High Turnover: On teams with high turnover rates the best engineers have an easy time finding new work and leave quickly, the worst engineers have a difficult time finding work and remain. This selects for a lower quality team over time.
Engineers who love their work The resolution is simple. Never have internal deadlines. Operate on a prioritized and ordered list of features. Estimate only when necessary to prioritize and do so in a t-shirt sizing way. Trust your engineers and they will begin to love their work. Engineers who love their work are happy and productive. Building is never a straight line