From db3afb307a70633467aafdfbd861cf6821cc1b52 Mon Sep 17 00:00:00 2001
From: kn0wmad <kn0wmad@protonmail.com>
Date: Thu, 8 Dec 2022 16:52:10 -0700
Subject: [PATCH] Add Flashing topic boxes and complete firmware flashing guide

---
 .../flashing/flashing-firmware.rst            | 16 +++++++-
 site/source/user-manual/flashing/index.rst    | 37 ++++++++++++++++++-
 2 files changed, 50 insertions(+), 3 deletions(-)

diff --git a/site/source/user-manual/flashing/flashing-firmware.rst b/site/source/user-manual/flashing/flashing-firmware.rst
index ad20a41..d32f3b2 100644
--- a/site/source/user-manual/flashing/flashing-firmware.rst
+++ b/site/source/user-manual/flashing/flashing-firmware.rst
@@ -17,6 +17,18 @@ The source code can be viewed on Purism's `firmware git repo <https://source.pur
 
     .. note:: You'll need a monitor and keyboard plugged into your Librem Mini for this operation
 
-#. Turn on the Librem Mini while pressing the ``ESC`` key on the keyboard repeatedly, until you see the following screen:
+#. Turn on the Librem Mini while pressing the ``ESC`` key on the keyboard repeatedly, until you see the PureBoot Bassic Boot Menu appear.
 
-    .. figure:: 
+#. Select "Options -->."
+
+#. Select "Flash/Update the BIOS".
+
+#. Select "Flash the firmware with a new ROM, erase settings."
+
+#. The system will ask if you want to proceed to flash the BIOS, select "Yes."
+
+#. Choose the file that we downloaded earlier: ``pureboot-librem_mini_v2-basic_usb_autoboot.rom.gz``.
+
+#. Confirm you want to proceed by selecting "Yes."
+
+#. The BIOS will be reflashed with the custom firmware.  This may take a few minutes.  When complete, remove the firmware USB (and insert your embassyOS USB if you are ready to install), then select "OK" to complete the process.
diff --git a/site/source/user-manual/flashing/index.rst b/site/source/user-manual/flashing/index.rst
index 36984b0..b6b7be1 100644
--- a/site/source/user-manual/flashing/index.rst
+++ b/site/source/user-manual/flashing/index.rst
@@ -6,10 +6,45 @@ Flashing
 
 Here you will find our flashing guides for ARM (Raspberry Pi) and x86 (most desktops, laptops, mini PCs, servers, etc) architectures. Librem Mini owners can use the firmware flashing guide to get embassyOS-specific firmware.
 
+.. raw:: html
+
+  <div class="topics-grid grid-container full">
+
+  <div class="grid-x grid-margin-x">
+
+.. topic-box::
+  :title: Flashing (ARM)
+  :link: flashing-arm
+  :icon: scylla-icon scylla-icon--apps
+  :class: large-4
+  :anchor: ARM Architecture
+
+  Flash embassyOS for use on a Raspberry Pi
+
+.. topic-box::
+  :title: Flashing (x86)
+  :link: flashing-x86
+  :icon: scylla-icon scylla-icon--overview
+  :class: large-4
+  :anchor: x86 Architecture
+
+  Flash embassyOS for use on an x86 machine
+
+.. topic-box::
+  :title: Flashing (Firmware)
+  :link: flashing-firmware
+  :icon: scylla-icon scylla-icon--integrations
+  :class: large-4
+  :anchor: Librem Mini Firmware
+
+  Flash custom eOS firmware on an existing Librem Mini
+
 .. toctree::
-  :includehidden:
+  :hidden:
   :maxdepth: 2
 
   flashing-arm
   flashing-x86
   flashing-firmware
+
+Appreciate what we're doing?  Please consider a `donation to Start9 <https://btcpay.start9.com/apps/2Et1JUmJnDwzKncfVBXvspeXiFsa/crowdfund>`_.