External links refactor (#47)

Fixes: #7 

Added missing links to external_links.yml file
Added some guidelines to yml
Created logical grouping and alphabetical order in yml
Eliminated hardwired URLs from admin guide
Fixed some missing id-s

Author: HofiOne

_data/external_links.yml

@@ -4,6 +4,8 @@ The syslog-ng.conf manual page
 The syslog-ng manual page
 
 >**NOTE:**
->If you experience any problems or need help with syslog-ng OSE, visit the syslog-ng mailing list. \
+>If you experience any problems or need help with syslog-ng OSE, visit
+>the syslog-ng mailing list.
+>  
 >For news and notifications about syslog-ng OSE, visit the syslog-ng blogs.
 {: .notice--info}

_includes/doc/admin-guide/manpages-footnote.md

@@ -2,8 +2,7 @@
 **NOTE:** The {{ page.app }} application is distributed with the syslog-ng OSE
 system logging application, and is usually part of the syslog-ng OSE
 package. The latest version of the syslog-ng OSE application is
-available at the [syslog-ng OSE page](https://syslog-ng.com/).
+available at the syslog-ng OSE page.
 {: .notice--info}
 
-This manual page is only an abstract, for the complete documentation of
-syslog-ng OSE, see the [syslog-ng OSE Documentation page](https://www.syslog-ng.com/).
+This manual page is only an abstract.

_includes/doc/admin-guide/manpages-intro.md

@@ -3,8 +3,7 @@
 |  Type:|      string|
   |Default:|   empty string|
 
-*Description:* Required. This option specifies your [Sumo Logic
-deployment](https://help.sumologic.com/APIs/General-API-Information/Sumo-Logic-Endpoints-and-Firewall-Security).
+*Description:* Required. This option specifies your Sumo Logic deployment.
 
 For details on the deployment() option in the sumologic-http()
 destination\'s declaration, see [[Declaration for the sumologic-http() destination|adm-dest-sumologic-http]].

_includes/doc/admin-guide/options/deployment.md

@@ -1,6 +1,6 @@
 ## keep-alive()
 
-This option configures the forwarding of [gRPC keepalive pings](https://grpc.io/docs/guides/keepalive/) in syslog-ng OSE.
+This option configures the forwarding of gRPC keepalive pings in syslog-ng OSE.
 
 ### max-pings-without-data()
 

_includes/doc/admin-guide/options/gRPC-keep-alive.md

@@ -55,7 +55,7 @@ syslog-ng OSE reload, use the following options:
 
 In the following example, the hook-commands() is used with the network()
 driver and it opens an
-[iptables](https://en.wikipedia.org/wiki/Iptables) port automatically as
+iptables port automatically as
 syslog-ng OSE is started/stopped.
 
 The assumption in this example is that the LOGCHAIN chain is part of a

_includes/doc/admin-guide/options/hook.md

@@ -10,7 +10,7 @@ external Python file. This option has no effect when the Python class is
 provided within the syslog-ng OSE configuration file (in a python{}
 block). You can use the loaders() option to modify the import mechanism
 that imports Python class. For example, that way you can use
-[hy](https://github.com/hylang/hy) in your Python class.
+hy in your Python class.
 
 ```config
 python(class(usermodule.HyParser) loaders(hy))

_includes/doc/admin-guide/options/loaders.md

@@ -6,7 +6,4 @@
 |                  | 1 - at least once (a much slower option than 0) |
 |                  | 2 - exactly once (the slowest option)           |
 
-*Description:* The [Quality of Service (QoS)
-level](https://www.hivemq.com/blog/mqtt-essentials-part-6-mqtt-quality-of-service-levels/)
-in MQTT messaging is an agreement between sender and receiver on the
-guarantee of delivering a message.
+*Description:* The Quality of Service (QoS) level in MQTT messaging is an agreement between sender and receiver on the guarantee of delivering a message.

_includes/doc/admin-guide/options/qos.md

@@ -47,9 +47,8 @@ To ensure at least a best effort level of reliability, One Identity
 recommends that you deploy a relay on the network, close to the source
 devices. With the most reliable hops between the source and the relay,
 you can minimize the risk of losing UDP packets. Once the packet arrives
-at the relay, [syslog-ng OSE](https://syslog-ng.com/blog/upgrading-from-syslog-ng-open-source-to-premium-edition/)
-ensures that the messages are delivered to the central server in a
-reliable manner, based on TCP/TLS.
+at the relay, syslog-ng OSE ensures that the messages are delivered to
+the central server in a reliable manner, based on TCP/TLS.
 
 ### Too many source devices
 

doc/_admin-guide/020_The_concepts_of_syslog-ng/002_Modes_of_operation.md

@@ -14,8 +14,8 @@ code package is under LGPL, the rest is GPL.
 {: .notice--info}
 
 For details about the LGPL and GPL licenses, see
-[[GNU Lesser General Public License|lgpl-license]] and
-[[GNU General Public License|gpl-license]], respectively.
+GNU Lesser General Public License and
+GNU General Public License, respectively.
 
 For clarity, the Documentation is licensed separately.
 For details, see The syslog-ng Open Source Edition Documentation License.