Archive of Decisions Records

We make decision posts (also known as “Decision Records”) that are inspired by Architectural Decision Records. These are structured records describing the reasons for why we choose certain tools, technologies, or processes for our software, our collaboration workflow, and our websites.

All our decisions adhere to our Guiding Principles.

Context and Problem Statement
Our reasons for …
Why Containerization

Containers are a way to bundle a software’s environment to simplify development, installation, and dependency management.

Dec 10, 2022
Why Discord
Our reasons for using Discord as our communication platform.
Jun 25, 2023
Why Django

Web frameworks are designed to support building a web frontend as well as the API layer. Django is a popular and widely used framework.

Mar 22, 2023
Why Docker

While there are several container technologies, Docker is one of the most popular and commonly used technologies.

Dec 14, 2022
Why Fly.io

Showcasing a demo of Seedcase software helps make things more tangible. This post describes our reasons for using Fly.io as a deployment host for showcasing our demo.

Dec 8, 2023
Why GitHub Projects
As a project grows, it becomes both more important and more difficult to keep track of where the project is at. This can be helped by using visualisation and project…
Nov 23, 2023
Why GitHub flow
Our reasons for using the GitHub flow as our branching and development strategy.
Feb 15, 2024
Why Material Design
We aim to utilise existing CSS or UI frameworks instead of building from scratch so Seedcase will look good with minimal effort. Since Material Design lives up to these…
Dec 15, 2023
Why Poetry
Our reasons for using Poetry for managing Python package dependencies when building Django and Python projects.
Jan 29, 2024
Why Postgres
SQL is the backbone of any database system. However there are many variants of SQL. This decision post contains the reasons for using PostgreSQL, which is a powerful and…
Jan 5, 2024
Why Python
Python is one of the most common and widely used programming languages. As it is used across multiple domains and industries, it is likely to be familiar to a wider…
Mar 22, 2023
Why Quarto
Our reasons for using Quarto to build the website and write the general documentation.
Jun 25, 2023
Why Ruff
Enforcing style of code with automatic linters and formatters is important for code reviews to focus on content, not style. This post covers the reasons why we decided on…
Nov 27, 2023
Why an MIT License
Open and permissive licensing of copyrighted content is a way to increase use of a software product, ease collaboration and re-use, and sharing intellectual ideas with…
Apr 1, 2023
Why poly-repo
Our reasons for structuring projects (both software and websites) in a poly-repo rather than mono-repo style.
Dec 5, 2023
Why standardized snippets
The larger a project is, the more important it becomes to have a joint set of standards when writing documentation. We decided to set up shortcuts that are shared across…
Nov 23, 2023
No matching items