From 3664adb95d4a0d17631d4cf3b2482281c18f8f0f Mon Sep 17 00:00:00 2001
From: Marian Beermann <public@enkore.de>
Date: Fri, 9 Jun 2017 13:57:27 +0200
Subject: [PATCH] docs: highlight experimental features in online docs

---
 docs/borg_theme/css/borg.css | 14 ++++++++++++++
 docs/conf.py                 |  4 ++++
 docs/usage/general.rst       |  7 +++++++
 3 files changed, 25 insertions(+)

diff --git a/docs/borg_theme/css/borg.css b/docs/borg_theme/css/borg.css
index ae807b461..f97b59078 100644
--- a/docs/borg_theme/css/borg.css
+++ b/docs/borg_theme/css/borg.css
@@ -38,3 +38,17 @@ dt code {
 #internals .toctree-wrapper > ul > li > ul {
     font-weight: normal;
 }
+
+.experimental,
+#debugging-facilities,
+#borg-recreate {
+    /* don't change text dimensions */
+    margin: 0 -40px; /* padding below + border width */
+    padding: 0 20px; /* 20 px visual margin between edge of text and the border */
+    /* fallback for browsers that don't have repeating-linear-gradient: thick, red lines */
+    border-left: 20px solid red;
+    border-right: 20px solid red;
+    /* fancy red-orange stripes */
+    border-image: repeating-linear-gradient(
+            -45deg,red 0,red 10px,#ffa800 10px,#ffa800 20px,red 20px) 0 20 repeat;
+}
diff --git a/docs/conf.py b/docs/conf.py
index 30171b3be..81c397bca 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -74,6 +74,10 @@ exclude_patterns = ['_build']
 # The reST default role (used for this markup: `text`) to use for all documents.
 #default_role = None
 
+# The Borg docs contain no or very little Python docs.
+# Thus, the primary domain is rst.
+primary_domain = 'rst'
+
 # If true, '()' will be appended to :func: etc. cross-reference text.
 #add_function_parentheses = True
 
diff --git a/docs/usage/general.rst b/docs/usage/general.rst
index 6b9ecd0a4..062d89c8d 100644
--- a/docs/usage/general.rst
+++ b/docs/usage/general.rst
@@ -5,6 +5,13 @@ Borg consists of a number of commands. Each command accepts
 a number of arguments and options and interprets various environment variables.
 The following sections will describe each command in detail.
 
+.. container:: experimental
+
+   Experimental features are marked with red-orange stripes on the sides, like this paragraph.
+
+   Experimental features are not stable, which means that they may be changed in incompatible
+   ways or even removed entirely without prior notice in following releases.
+
 .. include:: ../usage_general.rst.inc
 
 In case you are interested in more details (like formulas), please see