François Chollet's "Notes to Myself on Software Engineering"

Published by on 

Beutiful advice on how to work better with others and build great things.
I read this months ago but I'm just getting to posting about it now

Some gems I took away:

"Ask not what your pull request can do for your next promotion, ask what your pull request can do for your users and your community"

"It’s okay to say no — just because someone asks for a feature doesn’t mean you should do it."

"Good software makes hard things easy. Just because a problem looks difficult at first doesn’t mean the solution will have to be complex or hard to use."

"Simple things should be simple, complex things should be possible. Don’t increase the cognitive load of common use cases for the sake of niche use cases, even minimally."

"If the cognitive load of a workflow is sufficiently low, it should be possible for a user to go through it from memory (without looking up a tutorial or documentation) after having done it once or twice."

"Because code is communication, naming matters"

"Career progress is not how many people you manage, it is how much of an impact you make: the differential between a world with and without your work."

"Self-direction — agency over your work and your circumstances — is the key to life satisfaction. Make sure you grant sufficient self-direction to the people around you, and make sure your career choices result in greater agency for yourself."

"Productivity boils down to high-velocity decision-making and a bias for action. This requires a) good intuition, which comes from experience, so as to make generally correct decisions given partial information, b) a keen awareness of when to move more carefully and wait for more information, because the cost of an incorrect decision would be greater than cost of the delay. The optimal velocity/quality decision-making tradeoff can vary greatly in different environments."

"When we find ourselves in a conflict, it’s a good idea to pause to acknowledge our shared values and our shared goals, and remind ourselves that we are, almost certainly, on the same side."