From b74f34b8c2a9d2be0c8a5a210701c62a0de90c9f Mon Sep 17 00:00:00 2001
From: Aleks Volochnev <a.volochnev@gmail.com>
Date: Fri, 9 Oct 2026 14:17:08 +0200
Subject: [PATCH 1/2] Add an FAQ section to the landing page

---
 website/index.html | 19 +++++++++++++++++++
 website/styles.css | 25 +++++++++++++++++++++++++
 2 files changed, 44 insertions(+)

diff --git a/website/index.html b/website/index.html
index 73f74d5..421f54b 100644
--- a/website/index.html
+++ b/website/index.html
@@ -17,6 +17,7 @@
         <nav aria-label="Main">
           <a href="#features">Features</a>
           <a href="#self-hosting">Self-hosting</a>
+          <a href="#faq">FAQ</a>
           <a href="https://github.com/coderabbitai/ToDoRabbit">GitHub</a>
         </nav>
       </div>
@@ -67,6 +68,24 @@ <h2>Self-host in one command</h2>
           <p>Open <code>http://localhost:3000</code> and add your first task.</p>
         </div>
       </section>
+
+      <section id="faqs" class="faq">
+        <div class="container">
+          <h2>Frequently asked questions</h2>
+          <details>
+            <summary>Do I need to run a database server?</summary>
+            <p>No. ToDoRabbit stores your tasks in a SQLite file, so there is nothing else to install or maintain.</p>
+          </details>
+          <details>
+            <summary>How do I start the app after cloning?</summary>
+            <p>Run <code>make start</code> from the project root. Docker Compose builds both services and the app is available on port 3000.</p>
+          </details>
+          <details>
+            <summary>Can I use a different database?</summary>
+            <p>Yes. Set the <code>DATABASE_URL</code> environment variable to any SQLAlchemy async database URL.</p>
+          </details>
+        </div>
+      </section>
     </main>
 
     <footer class="site-footer">
diff --git a/website/styles.css b/website/styles.css
index 6cbf119..58670ab 100644
--- a/website/styles.css
+++ b/website/styles.css
@@ -140,6 +140,31 @@ a {
   padding: 64px 0;
 }
 
+.faq {
+  padding: 64px 0;
+  background: var(--surface);
+}
+
+.faq h2 {
+  margin: 0 0 24px;
+  font-size: 1.75rem;
+}
+
+.faq details {
+  padding: 16px 0;
+  border-bottom: 1px solid var(--border);
+}
+
+.faq summary {
+  cursor: pointer;
+  font-weight: 600;
+}
+
+.faq details p {
+  margin: 8px 0 0;
+  color: var(--muted);
+}
+
 pre {
   padding: 16px;
   overflow-x: auto;

From e8e225b9a84e2bca67ea48d42a1186d48b99f57f Mon Sep 17 00:00:00 2001
From: Aleks Volochnev <a.volochnev@gmail.com>
Date: Fri, 9 Oct 2026 21:18:23 +0200
Subject: [PATCH 2/2] Clarify the database URL answer in the FAQ

---
 website/index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/index.html b/website/index.html
index 421f54b..a513ec7 100644
--- a/website/index.html
+++ b/website/index.html
@@ -82,7 +82,7 @@ <h2>Frequently asked questions</h2>
           </details>
           <details>
             <summary>Can I use a different database?</summary>
-            <p>Yes. Set the <code>DATABASE_URL</code> environment variable to any SQLAlchemy async database URL.</p>
+            <p>Yes. Point the <code>DATABASE_URL</code> environment variable at any database that SQLAlchemy supports through an async driver.</p>
           </details>
         </div>
       </section>