From 1b07a68182697cf053626f87b043b3131156152b Mon Sep 17 00:00:00 2001
From: topunix <833824+topunix@users.noreply.github.com>
Date: Wed, 14 Oct 2026 16:16:10 -0500
Subject: [PATCH] Bug 1557154: Describe supported browsers in the User Guide

Add a Supported Browsers page to the User Guide, adapted from the browser support policy on the BMO wiki: full support for current Firefox (including the latest ESR), Chromium-based browsers and Safari; limited support for the previous release of each and for pre-release builds; Internet Explorer unsupported; JavaScript required for full functionality.
---
 docs/en/rst/using/browser-support.rst | 37 +++++++++++++++++++++++++++
 docs/en/rst/using/index.rst           |  1 +
 2 files changed, 38 insertions(+)
 create mode 100644 docs/en/rst/using/browser-support.rst

diff --git a/docs/en/rst/using/browser-support.rst b/docs/en/rst/using/browser-support.rst
new file mode 100644
index 0000000000..2dde033d0d
--- /dev/null
+++ b/docs/en/rst/using/browser-support.rst
@@ -0,0 +1,37 @@
+.. _browser-support:
+
+Supported Browsers
+##################
+
+Bugzilla is developed and tested against current desktop web browsers.
+
+Full support
+============
+
+* The current release of Firefox, including the latest Firefox Extended
+  Support Release (ESR)
+* The current release of Chrome and other Chromium-based browsers, such as
+  Microsoft Edge
+* The current release of Safari
+
+Limited support
+===============
+
+* The previous release of each browser listed above, including the previous
+  Firefox ESR
+* Pre-release builds, such as Firefox Nightly
+
+Bugzilla should work in these browsers, but problems that occur only in them
+may not be fixed.
+
+Not supported
+=============
+
+Internet Explorer is not supported. Some pages may still work in it, but no
+fixes are made for it.
+
+JavaScript
+==========
+
+JavaScript must be enabled for Bugzilla to work fully. Some pages work without
+it, but many features, including the bug page, depend on it.
diff --git a/docs/en/rst/using/index.rst b/docs/en/rst/using/index.rst
index 73aa707c31..e388c90f74 100644
--- a/docs/en/rst/using/index.rst
+++ b/docs/en/rst/using/index.rst
@@ -8,6 +8,7 @@ User Guide
    :maxdepth: 2
 
    creating-an-account
+   browser-support
    filing
    understanding
    editing