5 files changed, 37 insertions, 21 deletions
diff --git a/content/docs/gentoo/_index.md b/content/docs/gentoo/_index.md
index 3aa6307..9eef4df 100644
--- a/content/docs/gentoo/_index.md
+++ b/content/docs/gentoo/_index.md
@@ -1,8 +1,6 @@
 ---
 title: "Gentoo"
-linkTitle: "Gentoo"
-weight: 1
-description: >
-  Gentoo related articles
+description: Gentoo related articles
 ---
 
+I am a long time gentoo user, my first installation dating back to something like 2004.
diff --git a/content/docs/gentoo/installation.md b/content/docs/gentoo/installation.md
index 4f3be17..e4c29c5 100644
--- a/content/docs/gentoo/installation.md
+++ b/content/docs/gentoo/installation.md
@@ -1,11 +1,12 @@
 ---
 title: "Installation"
-linkTitle: "installation"
-weight: 1
-description: >
-  Installation of a gentoo system
+description: Installation of a gentoo system
 ---
 
+## Introduction
+
+When installing a gentoo system for the first time, please refer to the wonderfull [gentoo handbook](https://wiki.gentoo.org/wiki/Handbook:AMD64). This page is just installation notes shorthand when you know exactly what you are doing.
+
 ## Installation media
 
 You can get a bootable iso or liveusb from https://www.gentoo.org/downloads/. I recommend the minimal one. To create a bootable usb drive juste use `dd` to copy the image on it. Then boot on this brand new installation media.
@@ -17,6 +18,8 @@ Once you boot on the installation media, you can start sshd and set a temporary
 passwd
 {{< /highlight >}}
 
+Don't forget to either run `dhcpcd` or manually set an ip and gateway to the machine.
+
 ## Partitionning
 
 There are several options depending on wether you need soft raid, full disk encryption or a simple root device with no additional complications. It will also differ if you are using a virtual machine or a physical one.
@@ -50,6 +53,8 @@ mkfs.fat -F 32 -n efi-boot /dev/sda2
 mount /dev/sda3 /mnt/gentoo
 {{< /highlight >}}
 
+Make sure you do not repeat the mistake I too often make by mounting something to /mnt while using the liveusb/livecd. You will lose your shell if you do this and will need to reboot!
+
 ## Get the stage3 and chroot into it
 
 Get the stage 3 installation file from https://www.gentoo.org/downloads/. I personnaly use the non-multilib one from the advanced choices, since I am no longer using and 32bits software except steam, and I use steam from a multilib chroot.
@@ -178,6 +183,7 @@ scp root@collab-jde.nexen.net:/etc/hosts /etc/
 
 ### root account access
 
+I switched to an ed25512 ssh key some time ago but left this here for posterity :
 {{< highlight sh >}}
 mkdir -p /root/.ssh
 echo 'ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQDN1ha6PFKgxF3MSWUlDaruVVpj3UzoiN4IJEvDrCnDbIW8xu+TclbeGJSRXXBbqRKeUfhX0GDA7cvSUIAz2U7AGK7wq5tbzJKagVYtxcSHBSi6dZR9KGb3eoshnrCeFzem1jWXG02PZJGvjB+ml3QhUguyAqm9q0n/NL6zzKhGoKiELO+tQghGIY8jafRv4rE4yyXZnwuCu8JI9P8ldGhKgOPeOdKIVTIVezUmKILWgAF+Hg7O72rQqUua9sdoK1mEYme/wgu0bQbvN26owGgBAgS3uc2nngLD01TZToG/wC1wH9A3KxT6+3akjRlPfLOY0BuK4OBGEGm6e0KZrIMhUr8fHQ8nmTmBqw7puI0gIXYB2EjhpsQ7TijYVqLYXbyxaXYyqisgY0QRWC7Te5Io6TSgorfXzi7zrcQGgWByHkhxTylf36LYSKWEheIQIRqytOdGqeXagFMz2ptLFKk4dA61LS5fPXIJucdghvnmLPml8cO9/9VHQ7gq7DxQu7sIwt/W13yTTUyI9DSHwxeHUwECzxAb5pOVL6pRjTMH8q1/eAMl35TFSh6s5tGvvHGz9+gMlE9A2Pv8CyXDBmXV6srrwxTSlglnmgdq6c9w3VtBKu572/z0cS6vqZMgEno4rIiwyhqNWdjbMXYw/U0q/w5XC9zCcSuluxvaY14qqQ== adyxax
diff --git a/content/docs/gentoo/kernel_upgrades.md b/content/docs/gentoo/kernel_upgrades.md
index 0a2a65c..6b5cb60 100644
--- a/content/docs/gentoo/kernel_upgrades.md
+++ b/content/docs/gentoo/kernel_upgrades.md
@@ -1,11 +1,19 @@
 ---
 title: "Gentoo Kernel Upgrades"
-linkTitle: "Kernel Upgrades"
-weight: 1
-description: >
-  Gentoo kernel upgrades on adyxax.org
+description: Gentoo kernel upgrades on adyxax.org
 ---
-# Gentoo kernel upgrades
+
+## Introduction
+
+Now that I am mostly running OpenBSD servers I just use genkernel to build my custom configuration on each node with :
+{{< highlight sh >}}
+eselect kernel list
+eselect kernel set 1
+genkernel all  --kernel-config=/proc/config.gz --menuconfig
+nvim --diff /proc/config.gz /usr/src/linux/.config
+{{< / highlight >}}
+
+Bellow you will find how I did things previously when centralising the build of all kernels on a collab-jde machine, and distributing them all afterwards. Local nodes would only rebuild local modules and get on with their life.
 
 ## Building on collab-jde
 
diff --git a/content/docs/gentoo/lxd.md b/content/docs/gentoo/lxd.md
index d35c4d6..a13dc53 100644
--- a/content/docs/gentoo/lxd.md
+++ b/content/docs/gentoo/lxd.md
@@ -1,11 +1,14 @@
 ---
 title: "LXD"
-linkTitle: "LXD"
-weight: 1
-description: >
-  How to setup a LXD server
+description: How to setup a LXD server on gentoo
 ---
 
+## Introduction
+
+I have used LXD for many years successfully, I was never satisfied with the docker way of doing container images pulling who knows what from who knows where. Until recently I managed full machine containers running Alpine Linux and was very happy with the simplicity of it.
+
+## Installation
+
 {{< highlight sh >}}
 touch /etc{/subuid,/subgid}
 usermod --add-subuids 1000000-1065535 root
@@ -15,6 +18,8 @@ emerge -q app-emulation/lxd
 rc-update add lxd default
 {{< /highlight >}}
 
+## Initial configuration
+
 {{< highlight sh >}}
 myth /etc/init.d # lxd init
 Would you like to use LXD clustering? (yes/no) [default=no]:
diff --git a/content/docs/gentoo/steam.md b/content/docs/gentoo/steam.md
index 23b14b2..e49cb46 100644
--- a/content/docs/gentoo/steam.md
+++ b/content/docs/gentoo/steam.md
@@ -1,11 +1,10 @@
 ---
 title: "Steam"
-linkTitle: "Steam"
-weight: 1
-description: >
-  How to make steam work seamlessly on gentoo with a chroot
+description: How to make steam work seamlessly on gentoo with a chroot
 ---
 
+## Introduction
+
 I am not using a multilib profile on gentoo (I use amd64 only everywhere), so when the time came to install steam I had to get a little creative. Overall I believe this is the perfect
 way to install and use steam as it self contains it cleanly while not limiting the functionalities. In particular sound works, as does the hardware acceleration in games. I tried to
 achieve that with containers but didn't quite made it work as well as this chroot setup.