From 60b4a1028dfea233d738b783043134769808b155 Mon Sep 17 00:00:00 2001
From: Florian Maurer <f.maurer@outlook.de>
Date: Sat, 10 Feb 2024 07:31:33 +0100
Subject: [PATCH] docs gluon-tls: add documentation about gluon-tls feature

---
 docs/features/tls.rst     | 10 ++++++++++
 docs/index.rst            |  1 +
 docs/releases/v2023.2.rst |  1 +
 3 files changed, 12 insertions(+)
 create mode 100644 docs/features/tls.rst

diff --git a/docs/features/tls.rst b/docs/features/tls.rst
new file mode 100644
index 000000000..1c199091a
--- /dev/null
+++ b/docs/features/tls.rst
@@ -0,0 +1,10 @@
+TLS support
+===========
+
+The generic TLS implementation which is currently used by OpenWRT can be installed or added as dependency through the package ``gluon-tls``.
+This removes the need for community packages to depend on a specific TLS implementation (like mbedtls, OpenSSL or WolfSSL).
+
+This package is a placeholder for the current TLS implementation used.
+To allow for easy usage of communicating through HTTPS from the node, typical Certificate Authorities (CAs) are included through the package ``ca-bundle`` .
+
+* Starting with OpenWRT 23.05, mbedtls is the default TLS layer - this is reflected in Gluon :ref:`v2023.2 <releases-v2023.2-minor-changes>`. HTTPS is used by default to communicate with OpenWRT opkg servers.
diff --git a/docs/index.rst b/docs/index.rst
index d7bead47a..1d0774e2f 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -25,6 +25,7 @@ Several Freifunk communities in Germany use Gluon as the foundation of their Fre
   features/wlan-configuration
   features/private-wlan
   features/wired-mesh
+  features/tls
   features/dns-cache
   features/monitoring
   features/multidomain
diff --git a/docs/releases/v2023.2.rst b/docs/releases/v2023.2.rst
index 3d5969d98..d34ad45b6 100644
--- a/docs/releases/v2023.2.rst
+++ b/docs/releases/v2023.2.rst
@@ -288,6 +288,7 @@ Major changes
 This release is based on the newest OpenWrt 23.05 release branch.
 It ships with Linux kernel 5.15.y, wireless-backports 6.1.24 and batman-adv 2023.1.
 
+.. _releases-v2023.2-minor-changes:
 
 Minor changes
 -------------
-- 
GitLab