As mentioned in my previous post, my initial encounter with syncthing resulted in two tiny patches. Here follows the second of those:
From 525f83b340e0aa1fb5afbf92525c195ae64de030 Mon Sep 17 00:00:00 2001
From: cos <cos>
Date: Fri, 5 Apr 2024 10:22:49 +0200
Subject: [PATCH 2/2] Rephrase allowedNetworks for understandability
Given that the detailed description emphasize the word *remote*, it
appears to have been clear already in 572930bf that the naming makes
it easy to mistake what this option targets. I assume to not have been
the only one understanding it to mean the opposite of what it actually
does after reading the docs in its current wording
---
users/config.rst | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/users/config.rst b/users/config.rst
index 2d42b3c..dcd07e2 100644
--- a/users/config.rst
+++ b/users/config.rst
@@ -764,9 +764,9 @@ From the following child elements at least one ``address`` child must exist.
.. option:: device.allowedNetwork
:aliases: device.allowedNetworks
- If given, this restricts connections to this device to only this network.
- The mechanism is described in detail in a :doc:`separate chapter
- </advanced/device-allowednetworks>`).
+ If given, restricts to only connect to this device when it is reachable
+ through any of these networks. The mechanism is described in detail in a
+ :doc:`separate chapter </advanced/device-allowednetworks>`).
.. option:: device.autoAcceptFolders
--
2.46.1
I’m far from convinced my suggestion here actually improves things. However I am quite confident that the current phrasing is confusing. I believe misconceptions about how this configuration directive works has been the cause of questions asked independently from at least two other persons on irc since I joined the channel in April.