Kubernetes documentation feels like malicious compliance, a rebellion against the concept of clarity. Kubernetes lets you ask about anything with the command kubectl explain $thing. So I did: 1kubectl explain namespace The results make me wonder if anyone sober has read the 'explanations'. KIND: Namespace VERSION: v1 …

Read More

This article was written for the lazy bear's Vim Carnival I have notes on lots of things. When you write notes in markdown it's called 'a knowledge base', which sounds classy. So now I have lots of knowledge bases, and I strive to keep them bland and featureless. A good knowledge base has no fancy features. Features …

Read More

IT documentation has a disease: in-text links. The disease-inducing thinking is quite clear: someone writing the documentation writes 'install the drivers for your graphics card', and then provides a link to how to install graphics cards because they saw others do that sort of thing. But once you accept the general …

Read More

The absolute fucking state of Linux documentation shows undeniably that nobody ever reads it. Open a terminal, and just try, in earnest, to learn about what is happening: 1$ ? 2$ help 3 4 5GNU bash, version 5.2.37(1)-release (x86_64-pc-linux-gnu) 6These shell commands are defined internally. Type `help' to see this …

Read More

Neomutt exemplifies everything wrong with documentation. Neomutt advertises itself as an email client for the terminal. I like email, and I like terminal stuff, because it's easy to automate, and works with all my automation stuff. That was me, and probably a great many other unsuspecting victims of neomutt. However, …

Read More

Tired of fighting your computer, but not sure how to go about all this Linux stuff? If so, I wrote this for you. Overview Time Check your software works on Linux ~1 month Check what you need to back up 1 afternoon Downloads & a USB stick 30 minutes Pick a distro 1 minute Installation 1 hour Rediscover the computer 1 …

Read More

My grandmother had thirteen children. Each one was produced by her leaving in a taxi, and returning not-pregnant, and with a child. It's not that the waiting room was too close for comfort - someone had to stay to look after the children. On one of these occasions, my grandfather had to cook for the children. He took …

Read More

1sudo pacman -S docker 1sudo usermod -aG docker $USER 1sudo systemctl start docker You need to either log out and back in again to be in the docker group, or run everything as root. 1# docker info This should show you things are working. Search for a distro you want 1docker search debian If you get a hit, pull it. …

Read More

Basic VM Management 1xe vm-list Start, stop, et c. with xe: 1xe vm-start vm=$TARGET_VM 1xe vm-shutdown vm=$TARGET_VM Destruction requires the uuid. 1xe vm-destroy uuid=$TARGET_UUID Autocompletion works well with all of these commands. Shut Down VM List VMs. 1xe host-list 1xe vm-list resident-on=$HOST_UUID 1xe …

Read More