Sydney Staff SRE or something.

Documents Need A Purpose!

· by Robert Mibus · Read in about 1 min · (57 Words)
sre career communication

In my day job, I’m pretty regularly asked to review docs of various types - designs, roadmaps, strategies, … Sometimes people ask “what can I do to make this document better”, and my answer is almost always the same:

Understand the purpose of your document

It’s not “to be a design document”; that’s tautological rather than helpful.