Skip to content

Knowledge Base

Some of the challenges we face as Software & Tech experts within DevOps include:

  • Work of a highly complex & technical nature.
  • Large volumes of project-specific information.
  • A rapidly evolving technological landscape.

To help counter these, we curate & maintain a well-organised, readily accessible shared knowledge base.

This helps to lower complexity, improve accessibility, and alleviate cognitive load across numerous processes & procedures.

Following the Diataxis compass, this Guidebook defines site areas for 4 Knowledge Quadrants (KQs).

Click a KQ title below, or the equivalent navigation tab above, to explore that quadrant and the guides it contains.

Knowledge Quadrants

Tutorials

Tutorials Learning = Acquisition + Action

Learn to create & configure specific features & resources.

e.g. "How do I add automated releasing to my Python library?"

How-To's

How-To's Goals = Action + Application

Guided examples of common workflows.

e.g. "Walk me through making a new Python library?"

Explanations

Explanations Understanding = Acquisition + Cognition

Our mechanisms & the motivations behind them.

e.g. "Why do we use Poetry for packaging?"

Reference

Reference Information = Cognition + Application

Codex for specific information.

e.g. "What Python library do we use to implement REST APIs in Django apps?"