Docs housekeeping for SEO and syntax, part 1 (netdata#10388)

* First pass to get the script working right

* Finish adding analytics tags

BREAKING_CHANGES.md

@@ -1,10 +1,11 @@
 <!--
----
-title: "Breaking Changes"
+title: "Breaking changes"
+description: "On occasion, the Netdata team must make significant changes to the open-source Netdata Agent. We publish those breaking changes here for reference."
 custom_edit_url: https://github.com/netdata/netdata/edit/master/BREAKING_CHANGES.md
----
 -->
 
-# Breaking Changes
+# Breaking changes
 
 -   remove deprecated bash modules (`apache`, `cpu_apps`, `cpufreq`, `exim`, `hddtemp`, `load_average`, `mem_apps`, `mysql`, `nginx`, `phpfpm`, `postfix`, `squid`, `tomcat`) [[#7962](https://github.com/netdata/netdata/pull/7962)]
+
+[![analytics](https://www.google-analytics.com/collect?v=1&aip=1&t=pageview&_s=1&ds=github&dr=https%3A%2F%2Fgithub.com%2Fnetdata%2Fnetdata&dl=https%3A%2F%2Fmy-netdata.io%2Fgithub%2BREAKING_CHANGES&_u=MAC~&cid=5792dfd7-8dc4-476b-af31-da2fdb9f93d2&tid=UA-64295674-3)](<>)

BUILD.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "The build system"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/BUILD.md
----
 -->
 
 # The build system
@@ -364,3 +362,4 @@ Some smaller miscellaeneous suggestions:
 * [header checks in CMake](https://stackoverflow.com/questions/647892/how-to-check-header-files-and-library-functions-in-cmake-like-it-is-done-in-auto)
 * [how to write platform checks](https://gitlab.kitware.com/cmake/community/wikis/doc/tutorials/How-To-Write-Platform-Checks)
 
+[![analytics](https://www.google-analytics.com/collect?v=1&aip=1&t=pageview&_s=1&ds=github&dr=https%3A%2F%2Fgithub.com%2Fnetdata%2Fnetdata&dl=https%3A%2F%2Fmy-netdata.io%2Fgithub%2FBUILD&_u=MAC~&cid=5792dfd7-8dc4-476b-af31-da2fdb9f93d2&tid=UA-64295674-3)](<>)

CODE_OF_CONDUCT.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "Netdata Community Code of Conduct"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/CODE_OF_CONDUCT.md
----
 -->
 
 # Netdata Community Code of Conduct

REDISTRIBUTED.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "Redistributed software"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/REDISTRIBUTED.md
----
 -->
 
 # Redistributed software

SECURITY.md

@@ -1,8 +1,7 @@
 <!--
----
 title: "Security Policy"
+description: "The Netdata team maintains and adheres to a formal process any time a member of the community reports a security vulnerability."
 custom_edit_url: https://github.com/netdata/netdata/edit/master/SECURITY.md
----
 -->
 
 # Security Policy

backends/README.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "Metrics long term archiving"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/backends/README.md
----
 -->
 
 # Metrics long term archiving

backends/TIMESCALE.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "Writing metrics to TimescaleDB"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/backends/TIMESCALE.md
----
 -->
 
 # Writing metrics to TimescaleDB

backends/WALKTHROUGH.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "Netdata, Prometheus, Grafana stack"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/backends/WALKTHROUGH.md
----
 -->
 
 # Netdata, Prometheus, Grafana stack

backends/aws_kinesis/README.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "Using Netdata with AWS Kinesis Data Streams"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/backends/aws_kinesis/README.md
----
 -->
 
 # Using Netdata with AWS Kinesis Data Streams

backends/mongodb/README.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "MongoDB backend"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/backends/mongodb/README.md
----
 -->
 
 # MongoDB backend

backends/opentsdb/README.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "OpenTSDB with HTTP"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/backends/opentsdb/README.md
----
 -->
 
 # OpenTSDB with HTTP
@@ -36,3 +34,5 @@ After your proxy is configured, make the following changes to `netdata.conf`:
 
 In this example, we used the port `8082` for our reverse proxy. If your reverse proxy listens on a different port,
 change the `destination = localhost:8082` line accordingly.
+
+[![analytics](https://www.google-analytics.com/collect?v=1&aip=1&t=pageview&_s=1&ds=github&dr=https%3A%2F%2Fgithub.com%2Fnetdata%2Fnetdata&dl=https%3A%2F%2Fmy-netdata.io%2Fgithub%2Fbackends%2Fopentsdb%2FREADME&_u=MAC~&cid=5792dfd7-8dc4-476b-af31-da2fdb9f93d2&tid=UA-64295674-3)]()

backends/prometheus/README.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "Using Netdata with Prometheus"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/backends/prometheus/README.md
----
 -->
 
 # Using Netdata with Prometheus

backends/prometheus/remote_write/README.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "Prometheus remote write backend"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/backends/prometheus/remote_write/README.md
----
 -->
 
 # Prometheus remote write backend

build_external/README.md

@@ -1,9 +1,7 @@
 <!--
----
 title: "External build-system"
 date: 2020-03-31
 custom_edit_url: https://github.com/netdata/netdata/edit/master/build_external/README.md
----
 -->
 
 # External build-system
@@ -127,3 +125,4 @@ Notes:
 * There is not yet a good way to configure the target agent container from the docker-compose command line.
 * Several other containers should be in this compose (a paho client, tshark etc).
 
+[![analytics](https://www.google-analytics.com/collect?v=1&aip=1&t=pageview&_s=1&ds=github&dr=https%3A%2F%2Fgithub.com%2Fnetdata%2Fnetdata&dl=https%3A%2F%2Fmy-netdata.io%2Fgithub%2Fbuild_external%2FREADME&_u=MAC~&cid=5792dfd7-8dc4-476b-af31-da2fdb9f93d2&tid=UA-64295674-3)]()

claim/README.md

@@ -1,6 +1,6 @@
 <!--
 title: "Agent claiming"
-description: "Agent claiming allows a Netdata Agent, running on a distributed node, to securely connect to Netdata Cloud. A Space's administrator creates a claiming token, which is used to add an Agent to their Space via the Agent-Cloud link."
+description: "Agent claiming allows a Netdata Agent, running on a distributed node, to securely connect to Netdata Cloud via the encrypted Agent-Cloud link (ACLK)."
 custom_edit_url: https://github.com/netdata/netdata/edit/master/claim/README.md
 -->
 

cli/README.md

@@ -1,13 +1,12 @@
 <!--
----
-title: "Netdata cli"
+title: "Netdata CLI"
+description: "The Netdata Agent includes a command-line experience for reloading health configuration, reopening log files, halting the daemon, and more."
 custom_edit_url: https://github.com/netdata/netdata/edit/master/cli/README.md
----
 -->
 
-# Netdata cli
+# Netdata CLI
 
-You can see the commands netdatacli supports by executing it with `netdatacli` and entering `help` in
+You can see the commands `netdatacli` supports by executing it with `netdatacli` and entering `help` in
 standard input. All commands are given as standard input to `netdatacli`.
 
 The commands that a running netdata agent can execute are the following:

collectors/QUICKSTART.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "Collectors quickstart"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/collectors/QUICKSTART.md
----
 -->
 
 # Collectors quickstart
@@ -123,3 +121,5 @@ popular collectors.
 Finally, learn more advanced collector features, such as disabling plugins or developing a custom collector, in our
 [internal plugin API](/collectors/REFERENCE.md#internal-plugins-api) or our [external plugin
 docs](/collectors/plugins.d/README.md).
+
+[![analytics](https://www.google-analytics.com/collect?v=1&aip=1&t=pageview&_s=1&ds=github&dr=https%3A%2F%2Fgithub.com%2Fnetdata%2Fnetdata&dl=https%3A%2F%2Fmy-netdata.io%2Fgithub%2Fcollectors%2FQUICKSTART&_u=MAC~&cid=5792dfd7-8dc4-476b-af31-da2fdb9f93d2&tid=UA-64295674-3)]()

collectors/README.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "Collecting metrics"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/collectors/README.md
----
 -->
 
 # Collecting metrics

collectors/REFERENCE.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "Collectors configuration reference"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/collectors/REFERENCE.md
----
 -->
 
 # Collectors configuration reference
@@ -184,3 +182,5 @@ through this, is to examine what other similar plugins do.
 ## Write a custom collector
 
 You can add custom collectors by following the [external plugins documentation](../collectors/plugins.d/).
+
+[![analytics](https://www.google-analytics.com/collect?v=1&aip=1&t=pageview&_s=1&ds=github&dr=https%3A%2F%2Fgithub.com%2Fnetdata%2Fnetdata&dl=https%3A%2F%2Fmy-netdata.io%2Fgithub%2Fcollectors%2REFERENCE&_u=MAC~&cid=5792dfd7-8dc4-476b-af31-da2fdb9f93d2&tid=UA-64295674-3)]()

collectors/cgroups.plugin/README.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "cgroups.plugin"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/collectors/cgroups.plugin/README.md
----
 -->
 
 # cgroups.plugin

collectors/checks.plugin/README.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "checks.plugin"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/collectors/checks.plugin/README.md
----
 -->
 
 # checks.plugin

collectors/cups.plugin/README.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "cups.plugin"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/collectors/cups.plugin/README.md
----
 -->
 
 # cups.plugin
@@ -60,3 +58,5 @@ For each destination the plugin provides these charts:
     -   processing
 
 At the moment only job status pending, processing, and held are reported because we do not have a method to collect stopped, canceled, aborted and completed jobs which scales.
+
+[![analytics](https://www.google-analytics.com/collect?v=1&aip=1&t=pageview&_s=1&ds=github&dr=https%3A%2F%2Fgithub.com%2Fnetdata%2Fnetdata&dl=https%3A%2F%2Fmy-netdata.io%2Fgithub%2Fcollectors%2cups.plugin%2FREADME&_u=MAC~&cid=5792dfd7-8dc4-476b-af31-da2fdb9f93d2&tid=UA-64295674-3)]()

collectors/diskspace.plugin/README.md

@@ -1,8 +1,7 @@
 <!--
----
 title: "diskspace.plugin"
+description: "Monitor the disk usage space of mounted disks in real-time with the Netdata Agent, plus preconfigured alarms for disks at risk of filling up."
 custom_edit_url: https://github.com/netdata/netdata/edit/master/collectors/diskspace.plugin/README.md
----
 -->
 
 # diskspace.plugin

collectors/fping.plugin/README.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "fping.plugin"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/collectors/fping.plugin/README.md
----
 -->
 
 # fping.plugin

collectors/freebsd.plugin/README.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "freebsd.plugin"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/collectors/freebsd.plugin/README.md
----
 -->
 
 # freebsd.plugin

collectors/freeipmi.plugin/README.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "freeipmi.plugin"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/collectors/freeipmi.plugin/README.md
----
 -->
 
 # freeipmi.plugin

collectors/idlejitter.plugin/README.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "idlejitter.plugin"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/collectors/idlejitter.plugin/README.md
----
 -->
 
 # idlejitter.plugin

collectors/ioping.plugin/README.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "ioping.plugin"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/collectors/ioping.plugin/README.md
----
 -->
 
 # ioping.plugin

collectors/macos.plugin/README.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "macos.plugin"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/collectors/macos.plugin/README.md
----
 -->
 
 # macos.plugin

collectors/nfacct.plugin/README.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "nfacct.plugin"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/collectors/nfacct.plugin/README.md
----
 -->
 
 # nfacct.plugin

collectors/perf.plugin/README.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "perf.plugin"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/collectors/perf.plugin/README.md
----
 -->
 
 # perf.plugin

collectors/plugins.d/README.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "External plugins overview"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/collectors/plugins.d/README.md
----
 -->
 
 # External plugins overview

collectors/proc.plugin/README.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "proc.plugin"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/collectors/proc.plugin/README.md
----
 -->
 
 # proc.plugin

collectors/python.d.plugin/alarms/README.md

@@ -54,3 +54,5 @@ local:
 ```
 
 It will default to pulling all alarms at each time step from the Netdata rest api at `http://127.0.0.1:19999/api/v1/alarms?all`
+
+[![analytics](https://www.google-analytics.com/collect?v=1&aip=1&t=pageview&_s=1&ds=github&dr=https%3A%2F%2Fgithub.com%2Fnetdata%2Fnetdata&dl=https%3A%2F%2Fmy-netdata.io%2Fgithub%2Fcollectors%2Fpython.d.plugin%2Falarms%2FREADME&_u=MAC~&cid=5792dfd7-8dc4-476b-af31-da2fdb9f93d2&tid=UA-64295674-3)]()

collectors/python.d.plugin/am2320/README.md

@@ -50,3 +50,5 @@ Software install:
 - save the file.
 - restart the netdata service.
 - check the dashboard.
+
+[![analytics](https://www.google-analytics.com/collect?v=1&aip=1&t=pageview&_s=1&ds=github&dr=https%3A%2F%2Fgithub.com%2Fnetdata%2Fnetdata&dl=https%3A%2F%2Fmy-netdata.io%2Fgithub%2Fcollectors%2Fpython.d.plugin%2Fam2320%2FREADME&_u=MAC~&cid=5792dfd7-8dc4-476b-af31-da2fdb9f93d2&tid=UA-64295674-3)]()

collectors/python.d.plugin/anomalies/README.md

@@ -225,3 +225,5 @@ If you would like to go deeper on what exactly the anomalies collector is doing
 - [Mendeley public group](https://www.mendeley.com/community/interesting-anomaly-detection-papers/) with some interesting anomaly detection papers we have been reading.
 - Good [blog post](https://www.anodot.com/blog/what-is-anomaly-detection/) from Anodot on time series anomaly detection. Anodot also have some great whitepapers in this space too that some may find useful.
 - Novelty and outlier detection in the [scikit-learn documentation](https://scikit-learn.org/stable/modules/outlier_detection.html).
+
+[![analytics](https://www.google-analytics.com/collect?v=1&aip=1&t=pageview&_s=1&ds=github&dr=https%3A%2F%2Fgithub.com%2Fnetdata%2Fnetdata&dl=https%3A%2F%2Fmy-netdata.io%2Fgithub%2Fcollectors%2Fpython.d.plugin%2Fanomalies%2FREADME&_u=MAC~&cid=5792dfd7-8dc4-476b-af31-da2fdb9f93d2&tid=UA-64295674-3)]()

collectors/python.d.plugin/gearman/README.md

@@ -48,4 +48,4 @@ localhost:
 
 When no configuration file is found, module tries to connect to TCP/IP socket: `localhost:4730`.
 
----
+[![analytics](https://www.google-analytics.com/collect?v=1&aip=1&t=pageview&_s=1&ds=github&dr=https%3A%2F%2Fgithub.com%2Fnetdata%2Fnetdata&dl=https%3A%2F%2Fmy-netdata.io%2Fgithub%2Fcollectors%2Fpython.d.plugin%2Fgearman%2FREADME&_u=MAC~&cid=5792dfd7-8dc4-476b-af31-da2fdb9f93d2&tid=UA-64295674-3)]()

collectors/python.d.plugin/hpssa/README.md

@@ -51,3 +51,5 @@ If `ssacli` cannot be found in the `PATH`, configure it in `hpssa.conf`.
 ```yaml
 ssacli_path: /usr/sbin/ssacli
 ```
+
+[![analytics](https://www.google-analytics.com/collect?v=1&aip=1&t=pageview&_s=1&ds=github&dr=https%3A%2F%2Fgithub.com%2Fnetdata%2Fnetdata&dl=https%3A%2F%2Fmy-netdata.io%2Fgithub%2Fcollectors%2Fpython.d.plugin%2Fhpssa%2FREADME&_u=MAC~&cid=5792dfd7-8dc4-476b-af31-da2fdb9f93d2&tid=UA-64295674-3)]()

collectors/python.d.plugin/riakkv/README.md

@@ -124,3 +124,5 @@ With no explicit configuration given, the module will attempt to connect to
 The default update frequency for the plugin is set to 2 seconds as Riak
 internally updates the metrics every second. If we were to update the metrics
 every second, the resulting graph would contain odd jitter.
+
+[![analytics](https://www.google-analytics.com/collect?v=1&aip=1&t=pageview&_s=1&ds=github&dr=https%3A%2F%2Fgithub.com%2Fnetdata%2Fnetdata&dl=https%3A%2F%2Fmy-netdata.io%2Fgithub%2Fcollectors%2Fpython.d.plugin%2Friakkv%2FREADME&_u=MAC~&cid=5792dfd7-8dc4-476b-af31-da2fdb9f93d2&tid=UA-64295674-3)]()

collectors/slabinfo.plugin/README.md

@@ -1,8 +1,6 @@
 <!--
----
 title: "slabinfo.plugin"
 custom_edit_url: https://github.com/netdata/netdata/edit/master/collectors/slabinfo.plugin/README.md
----
 -->
 
 # slabinfo.plugin