How writing makes me a better software engineer, in 500 words
tldr.engineering
tldr.engineering
If you can't easily and lucidly describe in words how a system works, people will have trouble using it. In which case, you should probably consider a re-design or at least some modifications.
In the transition from logic gates, to machine codes, to assembly, to higher level languages like C, Java, Perl, Python.. the evolution is most often towards an abstraction or syntax closer to natural language.
And if the software industry prefers programming languages that at least superficially resemble natural languages, shouldn't it be obvious that we should actually start with the presumption that, the skills that make one good at writing (natural languages) can translate to skills writing programming languages?
I've seen otherwise great engineers who write illegible code (that works). Their written language skills are often not that great either.