From 29798cef73b27fbe55827ffdd2cba6c79d1e4c2e Mon Sep 17 00:00:00 2001
From: Gil Desmarais <gildesmarais@users.noreply.github.com>
Date: Wed, 8 Oct 2025 18:16:29 +0300
Subject: [PATCH] docs: centralize docker compose quick start

---
 .../docs/web-application/getting-started.mdx  |  4 +--
 .../web-application/how-to/deployment.mdx     | 29 ++++---------------
 2 files changed, 8 insertions(+), 25 deletions(-)

diff --git a/src/content/docs/web-application/getting-started.mdx b/src/content/docs/web-application/getting-started.mdx
index 7d9acc9..2162253 100644
--- a/src/content/docs/web-application/getting-started.mdx
+++ b/src/content/docs/web-application/getting-started.mdx
@@ -34,9 +34,9 @@ Ready to run your own html2rss-web instance? This guide walks you through every
 
 ---
 
-## Installation Guide
+## Docker Compose Quick Start {#docker-compose-quick-start}
 
-This guide will help you set up your own copy of html2rss-web on your computer. Don't worry - we'll walk you through every step!
+This is the canonical Docker Compose walkthrough for html2rss-web. Follow the steps below to set up your own copy on a local machine or server — we'll walk you through every detail!
 
 ### What You'll Need
 
diff --git a/src/content/docs/web-application/how-to/deployment.mdx b/src/content/docs/web-application/how-to/deployment.mdx
index f116d26..d07c94b 100644
--- a/src/content/docs/web-application/how-to/deployment.mdx
+++ b/src/content/docs/web-application/how-to/deployment.mdx
@@ -3,33 +3,16 @@ title: "Deployment & Production"
 description: "Deploy html2rss-web to production with Docker. Learn best practices for hosting public instances with security, monitoring, and reliability."
 ---
 
-import { Steps } from '@astrojs/starlight/components';
-
-html2rss-web is published on Docker Hub, making it easy to deploy with Docker. The [`docker-compose.yml`](https://github.com/html2rss/html2rss-web/blob/master/docker-compose.yml) from our [Installation Guide](/web-application/getting-started) provides a solid foundation for both development and production use.
+html2rss-web is published on Docker Hub, making it easy to deploy with Docker. The [`docker-compose.yml`](https://github.com/html2rss/html2rss-web/blob/master/docker-compose.yml) from our [Docker Compose Quick Start](/web-application/getting-started/#docker-compose-quick-start) provides a solid foundation for both development and production use.
 
 ## Quick Start
 
-<Steps>
-
-1. **Create a directory** for your instance:
-   ```bash
-   mkdir html2rss-web && cd html2rss-web
-   ```
-
-2. **Download the configuration** files:
-   ```bash
-   curl -O https://raw.githubusercontent.com/html2rss/html2rss-web/master/docker-compose.yml
-   curl -O https://raw.githubusercontent.com/html2rss/html2rss-web/master/config/feeds.yml
-   ```
-
-3. **Start the instance**:
-   ```bash
-   docker compose up -d
-   ```
-
-4. **Verify it's running** by opening [http://localhost:3000](http://localhost:3000) in your browser.
+For the full, step-by-step walkthrough, follow the [Docker Compose Quick Start](/web-application/getting-started/#docker-compose-quick-start). In brief, you'll:
 
-</Steps>
+- Create a project directory for html2rss-web
+- Download or create the provided `docker-compose.yml` and `feeds.yml`
+- Start the stack with `docker compose up -d`
+- Confirm the UI loads at [http://localhost:3000](http://localhost:3000)
 
 > 📖 Need Docker? Follow the [Docker installation guide](https://docs.docker.com/get-docker/) and [Docker Compose install](https://docs.docker.com/compose/install/).