fkr - exploration is key to excellence

Every now and then situations require a slim way of introducing documented processes to assure reproduceable outcomes and to achieve a certain quality. Yes - this is a discipline for which there are tons of frameworks, even more books and you can hire highly certified consultants ;) If the scope is to assist your team with its growth, it might be enough to just keep it very simple and just give a little guidance. A client of mine asked me last year to write them a small framework to get started with Standard Operating Procedures (SOPs). I’ve worked with SOPs a lot in the past and at one point we even aligned an ISO 27001 process along well defined SOPs. Yet, in its most basic ways all that is needed are simple, well-defined templates and some examples.

Simple SOP framework

I’ve assembled a very simple set of templates with some examples. Those are available in english and german. The work is MIT licensed.

Repository: https://git.sr.ht/~fkr/sop.

You can easily throw it in the wiki of your choice or just directly work within a git repository with it.

However when working with this and the client, I wanted to make it even more accessable. Accessable for people who don’t want to fiddle with git AND at the same time have it in the best accessable way for the tech-savy people in the team (eg. in a git repository).

Gollum-SOP

Gollum is a git-based Wiki. Gollum-SOP is an opinionated setup of Gollum in order to provide a lean and simple way of documenting Standard Operating Procedures (SOPs).

Gollum-SOP bundles gollum-auth with a custom patch to make it working with Gollum version 6. Furthermore some custom additions are added through config.ru.

To get started, you place a clone of the SOP repository as wiki into the Gollum-SOP checkout before starting it. Gollum-SOP comes with a dockerfile to get easily started.