feat(docs): New documentation

Convert docs to mkdocs, move back into repo, publish to repo

userdocs/debian/Dockerfile

@@ -0,0 +1,28 @@
+FROM debian
+
+# Disclaimer:
+# this is WIP and subject to change, ant feedback is highly appreciated
+
+# squelsh apt-get
+ENV DEBIAN_FRONTEND noninteractive
+ENV RUNLEVEL 1
+
+# ----- install vital packages -----
+# 'dbus' might makes sense as well
+RUN apt-get update && apt-get install -y --no-install-recommends \
+	kmod \
+	systemd-sysv \
+	openssh-client \
+	openssh-server \
+	isc-dhcp-client \
+	pciutils \
+	strace \
+	nfs-common \
+	ethtool\
+	ifupdown \
+	linux-image-amd64 \
+	ifmetric \
+	netbase && \
+	rm -rf /var/lib/apt/lists/*
+
+ENV DEBIAN_FRONTEND teletype

userdocs/debian/debian.md

@@ -0,0 +1,21 @@
+# Debian, Buster
+
+## Docker container
+
+### build and push
+
+> PSI specific, change for upstream
+
+change into your docker build directory
+```bash
+docker build -t docker.psi.ch:5000/debian:buster-slim .
+docker push docker.psi.ch:5000/debian:buster-slim
+```
+
+### import docker container into warewulf
+
+```bash
+wwctl container import docker://docker.psi.ch:5000/debian:buster-slim debian-10:slim
+```
+
+