From b495fe4acee13a8a964657ebfd016063b80d1084 Mon Sep 17 00:00:00 2001
From: c0dev0id <sh+git@codevoid.de>
Date: Mon, 6 Nov 2023 08:19:55 +0100
Subject: [PATCH] Update 2023-11-06 08:19:53

---
 src/posts/2023-11-06-OpenBSD_First_Steps.draft.pm | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/posts/2023-11-06-OpenBSD_First_Steps.draft.pm b/src/posts/2023-11-06-OpenBSD_First_Steps.draft.pm
index e1a6047..366809e 100644
--- a/src/posts/2023-11-06-OpenBSD_First_Steps.draft.pm
+++ b/src/posts/2023-11-06-OpenBSD_First_Steps.draft.pm
@@ -1,22 +1,22 @@
-# OpenBSD First Steps
+# OpenBSD: base and package management
 
 Note, each of the commands comes with a man page, which I encourage you to read. This post is merely to get you started. Also note, that there is [afterboot(8)](https://man.openbsd.org/afterboot).
 
 ## Base System
 
-### Upgrade the base system (will reboot)
+### Upgrade OpenBSD to the next version (will reboot)
 
 ```
 # sysupgrade
 ```
 
-### Update base system configuration after upgrade
+### Update base system configuration files after an OpenBSD upgrade
 
 ```
 # sysmerge
 ```
 
-### Update (patch) base system
+### Install security updates for the base system
 
 ```
 # syspatch
@@ -66,7 +66,7 @@ This does not need to be run manually. It's only relevant when you install hardw
 
 ### Check/repair package database
 
-If you don't know the answers to pkg_checks questions, deinstalling and reinstalling the package in question usually solves the problem.
+This command is only relevant if you see errors during `pkg_add`. This can happen if your system crashes while updating, which may get the package database into a weird state. If you don't know the answers to pkg_checks questions, deinstalling and reinstalling the package in question usually solves the problem.
 
 ```
 # pkg_check