From a92922e79ec152c34746f2f0a03d007f40608207 Mon Sep 17 00:00:00 2001
From: Manuel Thalmann <m@nuth.ch>
Date: Thu, 10 Nov 2022 10:31:38 +0100
Subject: [PATCH] Add a description for the SurfaceBook 2

---
 ManuSurface/ManuSurfaceSetup.md | 49 +++++++++++++++++++++++++++++++++
 README.md                       |  4 ++-
 2 files changed, 52 insertions(+), 1 deletion(-)
 create mode 100644 ManuSurface/ManuSurfaceSetup.md

diff --git a/ManuSurface/ManuSurfaceSetup.md b/ManuSurface/ManuSurfaceSetup.md
new file mode 100644
index 000000000..378848a3a
--- /dev/null
+++ b/ManuSurface/ManuSurfaceSetup.md
@@ -0,0 +1,49 @@
+# ManuSurface Setup
+The steps described here allow the creation of a linux system on a Surface Book 2.
+
+  - Rename host
+  - Install Brave
+  - Install Bitwarden
+  - Install snapd
+  - Install vscodium using snapd
+  - Generate SSH-key
+  - Install `linux-surface`  
+    See: <https://github.com/linux-surface/linux-surface/wiki/Installation-and-Setup>
+    - ```bash
+      wget -qO - https://raw.githubusercontent.com/linux-surface/linux-surface/master/pkg/keys/surface.asc \
+          | gpg --dearmor | sudo dd of=/etc/apt/trusted.gpg.d/linux-surface.gpg
+      ```
+    - ```bash
+      echo "deb [arch=amd64] https://pkg.surfacelinux.com/debian release main" \
+          | sudo tee /etc/apt/sources.list.d/linux-surface.list
+      ```
+    - ```bash
+      sudo apt update
+      ```
+  - Install `tea`
+    ```bash
+    wget https://dl.gitea.io/tea/0.9.0/tea-0.9.0-linux-amd64 -O tea
+    sudo install tea /usr/local/bin
+    ```
+
+## Post-Install
+  - Add SSH-key to GitHub/Gitea websites
+  - Add Caskaydia Cove Nerd Font Regular to /usr/share/font/opentype
+
+## Configuration
+  - Desktop
+    - Desktop Options
+      - Super Key Action: Applications
+  - Power
+    - Power Saving Options
+      - Disable "Automatic Screen Brightness"
+    - Suspend & Power Button
+      - Power Button Behavior: "Suspend"
+      - Enable "Show Battery Percentage"
+  - Mouse & Touchpad
+    - Touchpad Scroll & Zoom Options
+      - Enable "Natural Scrolling"
+  - Date & Time
+    - Time Format: 24-hour
+  - OS Upgrade & Recovery
+    - Update Recovery Partition
diff --git a/README.md b/README.md
index b99f61101..37f63798f 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,5 @@
 # PortValhalla
-
 Provides both scripts and descriptive texts explaining how to set up my personal experience on my private devices
+
+So far, scripts and explanations for the following devices have been added:
+  - [My Surface Book 2](./ManuSurface/ManuSurfaceSetup.md)