diff --git a/docs/code-howtos/walkthrough.md b/docs/code-howtos/walkthrough.md
new file mode 100644
index 00000000000..370fe21c671
--- /dev/null
+++ b/docs/code-howtos/walkthrough.md
@@ -0,0 +1,52 @@
+---
+parent: Code Howtos
+---
+
+# Walkthrough
+
+All walkthroughs are written using the internal declarative API (see `org.jabref.gui.walkthrough.declarative`) and are
+defined in the `WalkthroughAction` class. Each walkthrough is a linear series of steps, where each step is either a UI
+highlight (`VisibleComponent`) or an invisible side effect (`WalkthroughSideEffect`). The walkthroughs are built using a
+builder API (`Walkthrough.Builder`). To launch a walkthrough, simply construct a new `WalkthroughAction` and pass the
+name of the desired walkthrough.
+
+The `WalkthroughOverlay` renderer takes the output of the declarative API (`Walkthrough`) and renders it for the user.
+At a high level, a walkthrough primarily highlights GUI elements (nodes in the scene graph).
+
+The following step types are supported:
+
+## Highlights
+
+1. `Ring`: Shows a small, accent-colored circle in the upper-right corner of the node to be highlighted.
+   ![A blue, semi-transparent circle highlighting the "Preferences" button](../images/ring.png)
+2. `Spotlight`: Highlights the node of interest by darkening the rest of the window.
+   ![The "File" menu item highlighted with a spotlight effect](../images/backdrop.png)
+3. `FullScreenDarken`: Darkens the entire window, typically to display a panel in the center.
+   ![The entire application window darkened](../images/fullscreen-darken.png)
+
+## Visual Steps
+
+1. `TooltipStep`: Shows a tooltip next to a specified node. This step must be associated with a node to display
+   correctly.
+   ![A tooltip pointing to "Use Main File Directory"](../images/tooltip.png)
+2. `PanelStep`: Shows a panel with rich text and info boxes on the top, left, bottom, or right of the screen.
+   ![A information panel displayed at the top of the screen.](../images/panel-step.png)
+
+## Side Effects
+
+1. `OpenLibrarySideEffect`: Opens a specified example library.
+2. `EnsureSearchSettingsSideEffect`: Forces a search preference into a desired state.
+
+All walkthroughs are currently launched from the `Walkthroughs` component, which is located exclusively on the
+`WelcomeTab`.
+
+![The "Walkthroughs" section of the Welcome Tab, showing a list of available walkthroughs](../images/walkthroughs.png)
+
+## Quick Settings
+
+Since walkthroughs are only supposed to highlight UI components and guide the user through JabRef, quick settings are
+create so as to provide a convenient entry point for the user to edit the common settings like theme, online services,
+and main file directory. All the quick settings items are present in the `org.jabref.gui.welcome.components.QuickSettings`
+component, which is visible in the `WelcomeTab`.
+
+![The 'Quick Settings' section of the Welcome Tab, showing options for main file directory, theme, online settings, etc](../images/quicksettings.png)
diff --git a/docs/images/backdrop.png b/docs/images/backdrop.png
new file mode 100644
index 00000000000..d8f06c2bdde
Binary files /dev/null and b/docs/images/backdrop.png differ
diff --git a/docs/images/fullscreen-darken.png b/docs/images/fullscreen-darken.png
new file mode 100644
index 00000000000..8519c86eec9
Binary files /dev/null and b/docs/images/fullscreen-darken.png differ
diff --git a/docs/images/panel-step.png b/docs/images/panel-step.png
new file mode 100644
index 00000000000..243d452bc86
Binary files /dev/null and b/docs/images/panel-step.png differ
diff --git a/docs/images/quicksettings.png b/docs/images/quicksettings.png
new file mode 100644
index 00000000000..778b33aee9d
Binary files /dev/null and b/docs/images/quicksettings.png differ
diff --git a/docs/images/ring.png b/docs/images/ring.png
new file mode 100644
index 00000000000..9f77d2ec2eb
Binary files /dev/null and b/docs/images/ring.png differ
diff --git a/docs/images/tooltip.png b/docs/images/tooltip.png
new file mode 100644
index 00000000000..d64c91b7165
Binary files /dev/null and b/docs/images/tooltip.png differ
diff --git a/docs/images/walkthroughs.png b/docs/images/walkthroughs.png
new file mode 100644
index 00000000000..f7c0e25f08b
Binary files /dev/null and b/docs/images/walkthroughs.png differ