Welcome to bytewise.io, a collection of thoughts about software and people, with a bit of economics mixed in.
Your Best Docs Aren't Written Yet
How often does your team complain about poor-quality documentation? Internal docs are often in a state of being write-only, out-of-date, unfindable, incomplete or some combination of all of those. That architecture “diagram”? The last one was probably written 3 years ago and no one has a Lucid account anymore.
What’s the real problem?
What to do? First, take a step back. What are folks really complaining about?
Is it about documentation? Or understanding?
Continue reading
Software Mantra #2
Here’s another mantra that can be used to inform decision making, whether for development processes or tech choices (or anything, really).
What is everyone else doing?
Why?
Is it working?
Most of the problems your team or company are having have been encountered, and solved, by others already. This mantra pairs well with laying down sensible defaults for tech choices, and trying to prevent Not Invented Here Syndrome from developing.
Continue reading