From 1591a6c773be64c0b0a9ffbf372a2cf75bc264b8 Mon Sep 17 00:00:00 2001
From: Benoit Chesneau <bchesneau@gmail.com>
Date: Fri, 30 Jan 2026 01:29:45 +0100
Subject: [PATCH] fix: iPad mobile menu and documentation link warnings

- Fix mobile side menu not displaying on iPad by keeping site_nav
  content but hiding sidebar on desktop via CSS
- Fix broken links in asgi.md and guides/http2.md
- Add HTTP/2 guide to navigation
---
 docs/content/asgi.md         |  2 +-
 docs/content/guides/http2.md |  7 +++----
 mkdocs.yml                   |  1 +
 overrides/home.html          | 11 ++++++++++-
 4 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/docs/content/asgi.md b/docs/content/asgi.md
index d66e5818..a09a7190 100644
--- a/docs/content/asgi.md
+++ b/docs/content/asgi.md
@@ -241,7 +241,7 @@ asgi_lifespan = "auto"  # Auto-detect lifespan support
 | uvloop support | Yes | Yes | Yes |
 
 !!! note
-    HTTP/2 requires SSL/TLS and the h2 library. See [HTTP/2 Support](http2.md) for details.
+    HTTP/2 requires SSL/TLS and the h2 library. See [HTTP/2 Support](guides/http2.md) for details.
 
 Gunicorn's ASGI worker provides the same process management, logging, and
 configuration capabilities you're familiar with from WSGI deployments.
diff --git a/docs/content/guides/http2.md b/docs/content/guides/http2.md
index 6ef438b8..26480175 100644
--- a/docs/content/guides/http2.md
+++ b/docs/content/guides/http2.md
@@ -843,7 +843,6 @@ For public servers, you can use online tools:
 
 ## See Also
 
-- [Settings Reference](reference/settings.md#http2_max_concurrent_streams) - All HTTP/2 settings
-- [ASGI Worker](asgi.md) - ASGI worker with HTTP/2 support
-- [Deploy](deploy.md) - General deployment guidance
-- [SSL Configuration](deploy.md#using-ssl) - SSL/TLS setup
+- [Settings Reference](../reference/settings.md#http2_max_concurrent_streams) - All HTTP/2 settings
+- [ASGI Worker](../asgi.md) - ASGI worker with HTTP/2 support
+- [Deploy](../deploy.md) - General deployment guidance
diff --git a/mkdocs.yml b/mkdocs.yml
index 86d1c830..77b1e99d 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -15,6 +15,7 @@ nav:
   - Guides:
       - Deploy: deploy.md
       - Docker: guides/docker.md
+      - HTTP/2: guides/http2.md
       - ASGI Worker: asgi.md
       - Dirty Arbiters: dirty.md
       - uWSGI Protocol: uwsgi.md
diff --git a/overrides/home.html b/overrides/home.html
index 8defc14c..53e2bf7e 100644
--- a/overrides/home.html
+++ b/overrides/home.html
@@ -11,13 +11,22 @@
 {% block styles %}
 {{ super() }}
 <link rel="stylesheet" href="{{ 'assets/stylesheets/home.css' | url }}">
+<style>
+  /* Hide sidebar on desktop, keep drawer for mobile/tablet */
+  @media screen and (min-width: 76.25em) {
+    .md-sidebar--primary { display: none; }
+  }
+  .md-sidebar--secondary { display: none; }
+</style>
 {% endblock %}
 
 {% block hero %}{% endblock %}
 
 {% block content %}{% endblock %}
 
-{% block site_nav %}{% endblock %}
+{% block site_nav %}
+  {{ super() }}
+{% endblock %}
 
 {% block container %}
 <main class="home">