docs: factorize (#5411)

Signed-off-by: James Elliott <james-d-elliott@users.noreply.github.com>

docs/content/en/configuration/first-factor/ldap.md

@@ -121,8 +121,8 @@ This section describes the individual configuration options.
 
 {{< confkey type="string" required="yes" >}}
 
-*__Reference Note:__ This configuration option uses the [Address](../prologue/common.md#address) format. Please see the
+*__Reference Note:__ This configuration option uses the [address common syntax](../prologue/common.md#address). Please
-[documentation](../prologue/common.md#address) on this format for more information.*
+see the [documentation](../prologue/common.md#address) on this format for more information.*
 
 The LDAP URL which consists of a scheme, hostname, and port. Format is `[<scheme>://]<hostname>[:<port>]`. The default
 scheme is `ldapi` if the path is absolute otherwise it's `ldaps`, and the permitted schemes are `ldap`, `ldaps`, or
@@ -173,8 +173,11 @@ URL's are slightly more secure.
 
 ### tls
 
-Controls the TLS connection validation process. You can see how to configure the tls
+*__Reference Note:__ This configuration option uses the
-section [here](../prologue/common.md#tls-configuration).
+[TLS configuration common structure](../prologue/common.md#tls-configuration). Please see the
+[documentation](../prologue/common.md#tls-configuration) on this structure for more information.*
+
+Controls the TLS connection validation parameters for either StartTLS or the TLS socket.
 
 ### base_dn
 

docs/content/en/configuration/miscellaneous/server.md

@@ -190,13 +190,19 @@ research about how browsers utilize and understand this header before attempting
 
 ### buffers
 
-Configures the server buffers. See the [Server Buffers](../prologue/common.md#server-buffers) documentation for more
+*__Reference Note:__ This configuration option uses the
-information.
+[Server buffers common structure](../prologue/common.md#server-buffers). Please see the
+[documentation](../prologue/common.md#server-buffers) on this structure for more information.*
+
+Configures the server buffers.
 
 ### timeouts
 
-Configures the server timeouts. See the [Server Timeouts](../prologue/common.md#server-timeouts) documentation for more
+*__Reference Note:__ This configuration option uses the
-information.
+[Server timeouts common structure](../prologue/common.md#server-timeouts). Please see the
+[documentation](../prologue/common.md#server-timeouts) on this structure for more information.*
+
+Configures the server timeouts.
 
 ### endpoints
 

docs/content/en/configuration/notifications/smtp.md

@@ -232,8 +232,11 @@ mixed emails which contain both HTML and text so this option is rarely necessary
 
 ### tls
 
-Controls the TLS connection validation process. You can see how to configure the tls section
+*__Reference Note:__ This configuration option uses the
-[here](../prologue/common.md#tls-configuration).
+[TLS configuration common structure](../prologue/common.md#tls-configuration). Please see the
+[documentation](../prologue/common.md#tls-configuration) on this structure for more information.*
+
+Controls the TLS connection validation parameters for either StartTLS or the TLS socket.
 
 ## Using Gmail
 

docs/content/en/configuration/prologue/common.md

@@ -205,6 +205,11 @@ guide on configuring any particular instance.
 Various sections of the configuration use a uniform configuration section called TLS. Notably LDAP and SMTP.
 This section documents the usage.
 
+Various sections of the configuration use a uniform configuration section called `tls` which configure TLS socket and
+TLS verification parameters. Notably the [LDAP](../first-factor/ldap.md#tls), [SMTP](../notifications/smtp.md#tls),
+[PostgreSQL](../storage/postgres.md#tls), [MySQL](../storage/mysql.md#tls), and [Redis](../session/redis.md#tls)
+sections. This section documents the common parts of this structure.
+
 #### server_name
 
 {{< confkey type="string" required="no" >}}
@@ -263,6 +268,11 @@ is provided, in top down order, each certificate must be signed by the next cert
 
 ### Server Buffers
 
+Various sections of the configuration use a uniform configuration section called `buffers` which configure HTTP server
+buffers. Notably the [server](../miscellaneous/server.md#buffers) and
+[metrics telemetry](../telemetry/metrics.md#buffers) sections. This section documents the common parts of this
+structure.
+
 #### read
 
 {{< confkey type="integer" default="4096" required="no" >}}
@@ -277,6 +287,11 @@ Configures the maximum response size. The default of 4096 is generally sufficien
 
 ### Server Timeouts
 
+Various sections of the configuration use a uniform configuration section called `timeouts` which configure HTTP server
+timeouts. Notably the [server](../miscellaneous/server.md#timeouts) and
+[metrics telemetry](../telemetry/metrics.md#timeouts) sections. This section documents the common parts of this
+structure.
+
 #### read
 
 {{< confkey type="duration" default="6s" required="no" >}}

docs/content/en/configuration/session/redis.md

@@ -182,8 +182,12 @@ is useful if there are long delays in establishing connections.
 
 ### tls
 
-If defined enables [redis] over TLS, and additionally controls the TLS connection validation process. You can see how to
+*__Reference Note:__ This configuration option uses the
-configure the tls section [here](../prologue/common.md#tls-configuration).
+[TLS configuration common structure](../prologue/common.md#tls-configuration). Please see the
+[documentation](../prologue/common.md#tls-configuration) on this structure for more information.*
+
+If defined enables connecting to [redis] over a TLS socket, and additionally controls the TLS connection
+validation parameters.
 
 ### high_availability
 

docs/content/en/configuration/storage/mysql.md

@@ -182,8 +182,12 @@ The SQL connection timeout.
 
 ### tls
 
+*__Reference Note:__ This configuration option uses the
+[TLS configuration common structure](../prologue/common.md#tls-configuration). Please see the
+[documentation](../prologue/common.md#tls-configuration) on this structure for more information.*
+
 If defined enables connecting to [MySQL] or [MariaDB] over a TLS socket, and additionally controls the TLS connection
-validation process. You can see how to configure the tls section [here](../prologue/common.md#tls-configuration).
+validation parameters.
 
 [MySQL]: https://www.mysql.com/
 [MariaDB]: https://mariadb.org/

docs/content/en/configuration/storage/postgres.md

@@ -188,7 +188,11 @@ The SQL connection timeout.
 
 ### tls
 
+*__Reference Note:__ This configuration option uses the
+[TLS configuration common structure](../prologue/common.md#tls-configuration). Please see the
+[documentation](../prologue/common.md#tls-configuration) on this structure for more information.*
+
 If defined enables connecting to [PostgreSQL] over a TLS socket, and additionally controls the TLS connection
-validation process. You can see how to configure the tls section [here](../prologue/common.md#tls-configuration).
+validation parameters.
 
 [PostgreSQL]: https://www.postgresql.org/

docs/content/en/configuration/telemetry/metrics.md

@@ -69,13 +69,19 @@ This value should typically be prefixed with a `0` to ensure the relevant parser
 
 ### buffers
 
-Configures the server buffers. See the [Server Buffers](../prologue/common.md#server-buffers) documentation for more
+*__Reference Note:__ This configuration option uses the
-information.
+[Server buffers common structure](../prologue/common.md#server-buffers). Please see the
+[documentation](../prologue/common.md#server-buffers) on this structure for more information.*
+
+Configures the server buffers.
 
 ### timeouts
 
-Configures the server timeouts. See the [Server Timeouts](../prologue/common.md#server-timeouts) documentation for more
+*__Reference Note:__ This configuration option uses the
-information.
+[Server timeouts common structure](../prologue/common.md#server-timeouts). Please see the
+[documentation](../prologue/common.md#server-timeouts) on this structure for more information.*
+
+Configures the server timeouts.
 
 ## See More