Design docs, postmortems and more
Just to add in your list and am not sure if this is a common doc template but for proposing changes in current system/service/process or for justification of some major decisions there are ADRs doc. I have seen a fair amount of these docs in my current org.
This is really great, thank you
I signed up just to be able to say thank you for these!
Love those templates. I'd recommend them even to non-engineers.
My only take here is about the postmortem template. I always add a "Lesson Learned" section. I know those lessons are being inferred from the rest of the text. On the other hand, one of the most important reasons to have a postmortem is the learning opportunity.
In this section I try to dig deeper and find hidden problems in tooling, processes or anything else.
Great templates! If you are an engineer, I would definitely recommend taking a look at them and adapt them to your needs.
Thank you, Ryan, for providing these great templates. Besides reusing them in my work in the future, I can learn more about how you tackle a problem through these documents.
This is what I call being an engineer and not just someone who codes. As engineers we solve problems, we optimize solutions.
It's not only about optimizing the code. Processes like these are repetitive and we can have huge time savings by standardizing, templating and creating SOPs around them.
Thanks for sharing your templates, Ryan! The direction doc is one that I didn't have as a template and it would save me time and structure my thinking
I like how simple you kept the design doc aka RFCs, some be mega bloated.
I've always found it best to keep simple and not make it bloated and annoying haha
This is helpful Ryan. What I would add to this list is a template for taking notes in a meeting. I always try to write those up even just for myself. If I am the organiser, I use the same structure for formal MoMs that I will post to everybody. I mostly write this on a blank OneNote page with the Meeting Details inserted - I just throw in a couple of common Headings that I make sure to fill during the meeting, like Input(Description), Scope, Not in Scope, Deadline, Questions. People often give tasks without explicitly saying the deadline. This always ends in a misinterpretation by someone, so I make sure to ask about the deadline. I use the Questions part to write down my own questions which arise during the meeting, and then the answers when I get them. So it is not an actual file template because OneNote does not have such a feature, but its a short list which is worth much.
Some useful templates here, Ryan.
It is very useful for a developer to use these templates. It helps deliver better quality work and better organise the work overall
This is just brilliant. Thank you!