chore(kb): promote placeholders to todo articles

.vscode/settings.json

@@ -85,15 +85,16 @@
         "btrfs",
         "buildah",
         "buildkit",
+        "buildx",
         "burstable",
         "byod",
         "caldav",
         "celeron",
-        "cereda",
         "certmanager",
         "cfengine",
         "chage",
         "chattr",
+        "cheatsheet",
         "chezmoi",
         "chpass",
         "chsh",
@@ -101,6 +102,7 @@
         "clamd",
         "clamscan",
         "cloudinit",
+        "cloudquery",
         "commitlint",
         "commitlintrc",
         "compsize",
@@ -194,7 +196,9 @@
         "markdownlint",
         "mdlrc",
         "mktemp",
+        "mountpoint",
         "mpiexec",
+        "multiarch",
         "netcat",
         "nindent",
         "nmap",
@@ -230,7 +234,9 @@
         "pvresize",
         "radeon",
         "radicale",
+        "rego",
         "replicatedctl",
+        "resolv",
         "rfkill",
         "ripsecrets",
         "rmmod",
@@ -238,6 +244,7 @@
         "rootlv",
         "rootvg",
         "runbook",
+        "runc",
         "runcmd",
         "runtimes",
         "sata",
@@ -262,6 +269,7 @@
         "tcsh",
         "templating",
         "tfvars",
+        "tldr",
         "tmpfs",
         "tolerations",
         "tput",

knowledge base/acronyms and abbreviations.md

@@ -118,17 +118,18 @@
 - [Continuous delivery]
 
 <!--
-  References
+  Reference
+  ═╬═Time══
   -->
 
 <!-- Knowledge base -->
 [acl]: acl.md
-[adr]: adr.placeholder
+[adr]: adr.md
 [bash]: bash.md
-[cni]: cni.placeholder
+[cni]: cni.md
 [fhs]: fhs.placeholder
 [fish]: fish.md
-[iac]: iac.placeholder
+[iac]: iac.md
 [kubernetes]: kubernetes/README.md
 [ssh]: ssh.md
 [sssd]: sssd.md

knowledge base/adr.md

@@ -0,0 +1,23 @@
+# Architectural decision records
+
+TODO
+
+1. [Further readings](#further-readings)
+
+## Further readings
+
+- [Website]
+- [Github]
+- [Amazon's ADR process]
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- Upstream -->
+[github]: https://github.com/joelparkerhenderson/architecture-decision-record
+[website]: https://adr.github.io/
+
+<!-- Others -->
+[amazon's adr process]: https://docs.aws.amazon.com/prescriptive-guidance/latest/architectural-decision-records/adr-process.html

knowledge base/adr.placeholder

@@ -1,5 +0,0 @@
-# Architectural decision records
-
-https://adr.github.io/
-https://docs.aws.amazon.com/prescriptive-guidance/latest/architectural-decision-records/adr-process.html
-https://github.com/joelparkerhenderson/architecture-decision-record

knowledge base/best practices.md

@@ -12,15 +12,22 @@ What really worked for me.
 ## Generic concepts
 
 - Always think critically and question all the things. Especially those that don't appear to make any sense.<br/>
-  Don't just follow trends or advice from others. They _might_ know better, but you will be the one dealing with the issues in the end.
+  Don't just follow trends or advice from others. They _might_ know better, but you will be the one dealing with the
+  issues in the end.
 - Try to understand how something really works, may it be a technology, a tool or what else.<br/>
-  Try at least once to do manually what an automation would do in your place. Look at the source code of tools. Read the _fabulous_ documentation.
+  Try at least once to do manually what an automation would do in your place. Look at the source code of tools. Read the
+  _fabulous_ documentation.
 - Stay curious. Experiment. Learn and break things (in a sane and safe way). Dive deeper into what interests you.
 - Make the **informed** decision that most satisfies your **current** necessities.<br/>
-  There is no _perfect_ nor _correct_ solution, just different sets of tradeoff. Besides, no one will ever have all the information at the start, as some of them only come with experience and looking back at decisions one has already made gives the distorted perspective that those decisions were clearer than they really were.
+  There is no _perfect_ nor _correct_ solution, just different sets of tradeoff. Besides, no one will ever have all the
-- Review every decision after some time. Check they are still relevant, or if there is some improvement you can implement.<br/>
+  information at the start, as some of them only come with experience and looking back at decisions one has already made
-  Things change constantly: new technologies are given birth often, and processes improve. Also, now you know better then before.
+  gives the distorted perspective that those decisions were clearer than they really were.
-- Keep things simple (KISS approach) **with respect of your ultimate goal** and not only for the sake of simplicity.<br/>
+- Review every decision after some time. Check they are still relevant, or if there is some improvement you can
+  implement.<br/>
+  Things change constantly: new technologies are given birth often, and processes improve. Also, now you know better
+  then before.
+- Keep things simple (KISS approach) **with respect of your ultimate goal** and not only for the sake of
+  simplicity.<br/>
   Always going for the simple solution makes things complicated on a higher level.<br/>
   Check out [KISS principle is not that simple].
 - Beware of complex things that _should be simple_.<br/>
@@ -31,23 +38,29 @@ What really worked for me.
   Check out the [5 whys] approach.
 - Put in place processes to avoid repeating mistakes.
 - Automate when and where you can, yet mind [the automation paradox].
-- Automation does **not** necessarily involve [abstracting away][we have used too many levels of abstractions and now the future looks bleak].
+- Automation does **not** necessarily involve
-- Keep different parts **de**coupled where possible, the same way [_interfaces_ are used in programming][what does it mean to program to interfaces?].<br/>
+  [abstracting away][we have used too many levels of abstractions and now the future looks bleak].
+- Keep different parts **de**coupled where possible, the same way
+  [_interfaces_ are used in programming][what does it mean to program to interfaces?].<br/>
   This allows for quick and (as much as possible) painless switch between technologies.
 - The _one-size-fits-all_ approach is a big fat lie.<br/>
-  You'll end up with stiff, hard to change results that satisfy nobody. This proved particularly true with regards to templates and pipelines.
+  You'll end up with stiff, hard to change results that satisfy nobody. This proved particularly true with regards to
+  templates and pipelines.
 - Choose tools based on **how helpful** they are to achieve your goals.<br/>
   Do **not** adapt your work to specific tools.
 - Backup your data, especially when you are about to update something.<br/>
   [Murphy's law] is lurking. Consider [the 3-2-1 backup strategy].
 - [Branch early, branch often].
+- [Keep a changelog].
 - [Keep changes short and sweet][the art of small pull requests].<br/>
-  Nobody likes to dive deep into a 1200 lines, 356 files pull request ([PR fatigue][how to tackle pull request fatigue], everybody?).
+  Nobody likes to dive deep into a 1200 lines, 356 files pull request ([PR fatigue][how to tackle pull request fatigue],
+  everybody?).
 - Consider keeping changes in _behaviour_ (logic) separated from changes to the structure.<br/>
   It allows for easier debugging by letting you deal with one great issue at a time.
 - Make changes easy, avoid making easy changes.<br/>
   Easy changes will build up long term and become a pain to deal with.
-- [Trunk-based development][trunk-based development: a comprehensive guide] and other branching strategies all work.<br/>
+- [Trunk-based development][trunk-based development: a comprehensive guide] and other branching strategies all
+  work.<br/>
   Consider the [different pros and cons of each][git branching strategies vs. trunk-based development].
 - Refactoring _can_ be an option.<br/>
   Just **don't default** to it nor use it mindlessly.
@@ -68,7 +81,8 @@ What really worked for me.
   Then try to make them better.
 - Don't just dismiss your teammates' customs.<br/>
   E.g., use [EditorConfig] instead of your editor's specific setting files only.
-- You, your teammates and other teams in your company _should be_ on the same boat and _should be_ shooting for the same goal.<br/>
+- You, your teammates and other teams in your company _should be_ on the same boat and _should be_ shooting for the same
+  goal.<br/>
   Act like it. You may as well collaborate instead of fighting.
 
 ## CI/CD specific
@@ -80,7 +94,8 @@ What really worked for me.
 ### Pipelining
 
 - Differentiate what the concept of pipelines really is from the idea of pipelines in approaches like DevOps.<br/>
-  Pipelines are sequences of actions. Pipelines in DevOps and alike end up being magic tools to take actions away from people.
+  Pipelines are sequences of actions. Pipelines in DevOps and alike end up being magic tools to take actions away from
+  people.
 - Keep in mind [the automation paradox].<br/>
   Pipelines tend to easily become complex systems just like Rube Goldberg machines.
 - Keep tasks as simple, consistent and reproducible as possible.<br/>
@@ -90,7 +105,8 @@ What really worked for me.
 - Consider using local automation to guarantee basic quality **before** the code reaches the shared repository.<br/>
   Tools like [`pre-commit`][pre-commit] or [`lefthook`][lefthook] are a doozy for this.
 - DevOps pipelines are meant to be used as **last mile** steps for specific goals.<br/>
-  There **cannot** be a single pipeline for everything, the same way as the _one-size-fits-all_ concept never really works.
+  There **cannot** be a single pipeline for everything, the same way as the _one-size-fits-all_ concept never really
+  works.
 
 ## Product engineering
 
@@ -101,9 +117,11 @@ Consider what follows for infrastructure and platform engineering as well.
 - Focus on small audiences first. Avoid trying appealing lots of users from the beginning.<br/>
   If you do not have a user base, the product has no reason to exist but your will to create it.
 - Consider and fix users' pain points **before** adding new features.<br/>
-  If users are not happy with your tool they'll try moving away from it, bringing the discussion back to the previous point in this list.
+  If users are not happy with your tool they'll try moving away from it, bringing the discussion back to the previous
+  point in this list.
 - Avoid creating mindless abstractions, like templates using variables for all their attributes.<br/>
-  Prefer providing one or at most a few simplified solutions that use different [adapters or interfaces][what does it mean to program to interfaces?] in the background instead.<br/>
+  Prefer providing one or at most a few simplified solutions that use different
+  [adapters or interfaces][what does it mean to program to interfaces?] in the background instead.<br/>
   E.g., check out how [Crossplane] works.
 
 ## Sources
@@ -143,6 +161,7 @@ Listed in order of addition:
 <!-- Knowledge base -->
 [crossplane]: https://www.crossplane.io/
 [editorconfig]: editorconfig.md
+[keep a changelog]: keep%20a%20changelog.md
 [lefthook]: lefthook.md
 [pre-commit]: pre-commit.md
 [safe]: safe.placeholder

knowledge base/changelog.placeholder

@@ -1,2 +0,0 @@
-https://keepachangelog.com/en/1.1.0/
-https://github.com/olivierlacan/keep-a-changelog

knowledge base/cni.md

@@ -0,0 +1,17 @@
+# Container Network Interface
+
+TODO
+
+1. [Further readings](#further-readings)
+
+## Further readings
+
+- [Website]
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- Upstream -->
+[website]: https://www.cni.dev/

knowledge base/cni.placeholder

@@ -1 +0,0 @@
-https://www.cni.dev/

knowledge base/containerd.md

@@ -0,0 +1,25 @@
+# Containerd
+
+TODO
+
+1. [Further readings](#further-readings)
+
+## Further readings
+
+- [Website]
+- [Github]
+- [Docker]
+- [NerdCTL]
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- Knowledge base -->
+[docker]: docker.md
+[nerdctl]: nerdctl.md
+
+<!-- Upstream -->
+[github]: https://github.com/containerd/containerd
+[website]: https://containerd.io/

knowledge base/containerd.placeholder

@@ -1,4 +0,0 @@
-https://github.com/containerd/containerd
-
-[docker]: docker.md
-[nerdctl]: nerdctl.placeholder

knowledge base/docker.md

@@ -235,7 +235,8 @@ sudo vim "$(docker volume inspect --format '{{.Mountpoint}}' 'gitea_config')/app
   8eaaae8c0c72   hello-world   "/hello"   21 seconds ago   Created           sleepy_brown
   ```
 
-- When referring to a container or image using their ID, you just need to use as many characters you need to uniquely specify a single one of them:
+- When referring to a container or image using their ID, you just need to use as many characters you need to uniquely
+  specify a single one of them:
 
   ```sh
   $ docker ps -a
@@ -252,8 +253,10 @@ sudo vim "$(docker volume inspect --format '{{.Mountpoint}}' 'gitea_config')/app
   8eaaae8c0c72   hello-world   "/hello"   45 seconds ago   Exited (0) 10 seconds ago           sleepy_brown
   ```
 
-- Docker's host networking feature is not supported on Mac, even though the `docker run` command doesn't complain about it.<br/>
+- Docker's host networking feature is not supported on Mac, even though the `docker run` command doesn't complain about
-  This is due to the fact that the Docker daemon on Mac is running in a virtual machine, and not natively; hence, ports are exposed on the VM and not of the host running it.<br/>
+  it.<br/>
+  This is due to the fact that the Docker daemon on Mac is running in a virtual machine, and not natively; hence, ports
+  are exposed on the VM and not of the host running it.<br/>
   One way around it is port forwarding to localhost (the `-p` or `-P` options).
 
 ## Daemon configuration
@@ -393,9 +396,9 @@ docker load …
   -->
 
 <!-- Knowledge base -->
-[containerd]: containerd.placeholder
+[containerd]: containerd.md
 [dive]: dive.placeholder
-[podman]: podman.placeholder
+[podman]: podman.md
 [testcontainers]: testcontainers.placeholder
 
 <!-- Upstream -->

knowledge base/harvester hci.placeholder

@@ -6,5 +6,5 @@ Hyperconverged infrastructure (HCI) solution by SUSE built for bare metal server
 
 [kubernetes]: kubernetes/README.md
 [kubevirt]: kubernetes/kubevirt.placeholder
-[kvm]: kvm.placeholder
+[kvm]: kvm.md
 [longhorn]: kubernetes/longhorn.placeholder

knowledge base/iac.md

@@ -0,0 +1,26 @@
+# Infrastructure as Code
+
+TODO
+
+1. [Further readings](#further-readings)
+
+Personal preference:
+
+[Pulumi] > [OpenTofu] > [Terraform] > [Ansible]
+
+## Further readings
+
+- [Pulumi]
+- [Terraform] / [OpenTofu]
+- [Ansible]
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- Knowledge base -->
+[ansible]: pulumi.md
+[opentofu]: opentofu.md
+[pulumi]: pulumi.md
+[terraform]: terraform.md

knowledge base/iac.placeholder

@@ -1 +0,0 @@
-# Infrastructure as Code

knowledge base/iam.md

@@ -0,0 +1,25 @@
+# Identity and Access Management
+
+TODO
+
+1. [Further readings](#further-readings)
+
+## Further readings
+
+Solutions:
+
+- [Authelia]
+- [Authentik]
+- [Hydra]
+- [Keycloak]
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- Others -->
+[authelia]: https://www.authelia.com/
+[authentik]: https://goauthentik.io/
+[hydra]: https://www.ory.sh/hydra/
+[keycloak]: https://www.keycloak.org/

knowledge base/iam.placeholder

@@ -1,4 +0,0 @@
-[authelia]: https://www.authelia.com/
-[authentik]: https://goauthentik.io/
-[keycloak]: https://www.keycloak.org/
-[hydra]: https://www.ory.sh/hydra/

knowledge base/json-schema.md

@@ -0,0 +1,17 @@
+# JSON schema
+
+TODO
+
+1. [Further readings](#further-readings)
+
+## Further readings
+
+- [Website]
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- Upstream -->
+[website]: https://json-schema.org/

knowledge base/json-schema.placeholder

@@ -1 +0,0 @@
-https://json-schema.org/

knowledge base/keep a changelog.md

@@ -0,0 +1,19 @@
+# Keep a changelog
+
+TODO
+
+1. [Further readings](#further-readings)
+
+## Further readings
+
+- [Website]
+- [Github]
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- Upstream -->
+[github]: https://github.com/olivierlacan/keep-a-changelog
+[website]: https://keepachangelog.com/en/1.1.0/

knowledge base/kubernetes/rancher.md

@@ -0,0 +1,27 @@
+# Rancher
+
+TODO
+
+1. [Further readings](#further-readings)
+
+## Further readings
+
+- [Website]
+- [Rancher Kubernetes Engine (RKE)][rke]
+- [Rancher desktop]
+- [Containerd]
+- [Docker]
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- Knowledge base -->
+[containerd]: ../containerd.md
+[docker]: ../docker.md
+[rancher desktop]: ../rancher%20desktop.md
+
+<!-- Upstream -->
+[rke]: https://rke.docs.rancher.com/
+[website]: https://www.rancher.com/

knowledge base/kubernetes/rancher.placeholder

@@ -1,8 +0,0 @@
-# Rancher
-
-[website]: https://www.rancher.com/
-[rke]: https://rke.docs.rancher.com/
-
-[containerd]: ../containerd.placeholder
-[docker]: ../docker.md
-[rancher desktop]: ../rancher%20desktop.placeholder

knowledge base/kvm.md

@@ -0,0 +1,17 @@
+# KVM
+
+Full virtualization solution for Linux on x86 hardware.
+
+1. [Further readings](#further-readings)
+
+## Further readings
+
+- [Website]
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- Upstream -->
+[website]: https://linux-kvm.org/page/Main_Page

knowledge base/kvm.placeholder

@@ -1,5 +0,0 @@
-# KVM
-
-Full virtualization solution for Linux on x86 hardware.
-
-[website]: https://linux-kvm.org/page/Main_Page

knowledge base/nerdctl.md

@@ -0,0 +1,22 @@
+# NerdCTL
+
+TODO
+
+Docker-compatible CLI for [Containerd].
+
+1. [Further readings](#further-readings)
+
+## Further readings
+
+- [Github]
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- Knowledge base -->
+[containerd]: containerd.md
+
+<!-- Upstream -->
+[github]: https://github.com/containerd/nerdctl

knowledge base/nerdctl.placeholder

@@ -1,3 +0,0 @@
-https://github.com/containerd/nerdctl
-
-[containerd]: containerd.placeholder

knowledge base/nix.md

@@ -4,7 +4,7 @@
 
 1. [TL;DR](#tldr)
 1. [Further readings](#further-readings)
-1. [Sources](#sources)
+   1. [Sources](#sources)
 
 ## TL;DR
 
@@ -95,22 +95,18 @@ rm -rf '/nix'
 - [Website]
 - [NixOS]
 
-## Sources
+### Sources
-
-All the references in the [further readings] section, plus the following:
 
 - [Manual]
 
 <!--
-  References
+  Reference
+  ═╬═Time══
   -->
 
+<!-- Knowledge base -->
+[nixos]: nixos.md
+
 <!-- Upstream -->
 [manual]: https://nix.dev/manual/nix/2.19/
 [website]: https://nix.dev
-
-<!-- In-article sections -->
-[further readings]: #further-readings
-
-<!-- Knowledge base -->
-[nixos]: nixos.placeholder

knowledge base/nixos.md

@@ -0,0 +1,17 @@
+# NixOS
+
+TODO
+
+1. [Further readings](#further-readings)
+
+## Further readings
+
+- [Website]
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- Upstream -->
+[website]: https://nixos.org

knowledge base/nixos.placeholder

@@ -1 +0,0 @@
-https://nixos.org

knowledge base/opa.md

@@ -1,6 +1,21 @@
 # Open Policy Agent
 
+TODO
+
 Open source, general-purpose policy engine.
 
+1. [Further readings](#further-readings)
+
+## Further readings
+
+- [Website]
+- [Rego]
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- Upstream -->
 [rego]: https://www.openpolicyagent.org/docs/latest/policy-language/
 [website]: https://www.openpolicyagent.org/

knowledge base/podman.md

@@ -22,11 +22,12 @@ sudo zypper install 'podman'
 - [Docker]
 
 <!--
-  References
+  Reference
+  ═╬═Time══
   -->
 
-<!-- Upstream -->
-[website]: https://podman.io/
-
 <!-- Knowledge base -->
 [docker]: docker.md
+
+<!-- Upstream -->
+[website]: https://podman.io/

knowledge base/rancher desktop.md

@@ -0,0 +1,25 @@
+# Rancher Desktop
+
+TODO
+
+1. [Further readings](#further-readings)
+
+## Further readings
+
+- [Website]
+- [Rancher]
+- [Containerd]
+- [Docker]
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- Knowledge base -->
+[containerd]: containerd.md
+[docker]: docker.md
+[rancher]: kubernetes/rancher.md
+
+<!-- Upstream -->
+[website]: https://rancherdesktop.io/

knowledge base/rancher desktop.placeholder

@@ -1,7 +0,0 @@
-# Rancher Desktop
-
-[website]: https://rancherdesktop.io/
-
-[containerd]: containerd.placeholder
-[docker]: docker.md
-[rancher]: kubernetes/rancher.placeholder

knowledge base/toolbox.md

@@ -2,11 +2,9 @@
 
 Runs on top of [Podman].
 
-## Table of contents <!-- omit in toc -->
-
 1. [TL;DR](#tldr)
 1. [Further readings](#further-readings)
-1. [Sources](#sources)
+   1. [Sources](#sources)
 
 ## TL;DR
 
@@ -43,17 +41,18 @@ toolbox rmi -af
 - [GitHub] page
 - [Podman]
 
-## Sources
+### Sources
 
 - [Fedora Silverblue]
 
 <!--
-  References
+  Reference
+  ═╬═Time══
   -->
 
+<!-- Knowledge base -->
+[podman]: podman.md
+
 <!-- Upstream -->
 [fedora silverblue]: https://docs.fedoraproject.org/en-US/fedora-silverblue/toolbox/
 [github]: https://github.com/containers/toolbox
-
-<!-- Knowledge base -->
-[podman]: podman.placeholder