DOCS: Clean up formatting and punctuation (#1776)

Co-authored-by: Tom Limoncelli <tlimoncelli@stackoverflow.com>

docs/_functions/domain/A.md

@@ -10,7 +10,7 @@ A adds an A record To a domain. The name should be the relative label for the re
 
 The address should be an ip address, either a string, or a numeric value obtained via [IP](#IP).
 
-Modifiers can be any number of [record modifiers](#record-modifiers) or json objects, which will be merged into the record's metadata.
+Modifiers can be any number of [record modifiers](#record-modifiers) or JSON objects, which will be merged into the record's metadata.
 
 {% capture example %}
 ```js

docs/_functions/domain/AAAA.md

@@ -10,7 +10,7 @@ AAAA adds an AAAA record To a domain. The name should be the relative label for
 
 The address should be an IPv6 address as a string.
 
-Modifiers can be any number of [record modifiers](#record-modifiers) or json objects, which will be merged into the record's metadata.
+Modifiers can be any number of [record modifiers](#record-modifiers) or JSON objects, which will be merged into the record's metadata.
 
 {% capture example %}
 ```js

docs/_functions/domain/AKAMAICDN.md

@@ -1,9 +1,9 @@
 ---
 name: AKAMAICDN
 parameters:
-- name
-- target
-- modifiers...
+  - name
+  - target
+  - modifiers...
 ---
 
 AKAMAICDN is a proprietary record type that is used to configure [Zone Apex Mapping](https://blogs.akamai.com/2019/08/fast-dns-zone-apex-mapping-dnssec.html).

docs/_functions/domain/TXT.md

@@ -16,7 +16,7 @@ Each string is a JavaScript string (quoted using single or double
 quotes).  The (somewhat complex) quoting rules of the DNS protocol
 will be done for you.
 
-Modifiers can be any number of [record modifiers](#record-modifiers) or json objects, which will be merged into the record's metadata.
+Modifiers can be any number of [record modifiers](#record-modifiers) or JSON objects, which will be merged into the record's metadata.
 
 {% capture example %}
 ```js

docs/_functions/global/FETCH.md

@@ -7,7 +7,7 @@ parameters:
 
 `FETCH` is a wrapper for the [Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API). This allows dynamically setting DNS records based on an external data source, e.g. the API of your cloud provider.
 
-Compared to `fetch` from Fetch API, `FETCH` will call [PANIC](#PANIC) to terminate the execution of the script, and therefore DnsControl, if a network error occurs.
+Compared to `fetch` from Fetch API, `FETCH` will call [PANIC](#PANIC) to terminate the execution of the script, and therefore DNSControl, if a network error occurs.
 
 Otherwise the syntax of `FETCH` is the same as `fetch`.
 
@@ -16,7 +16,7 @@ Otherwise the syntax of `FETCH` is the same as `fetch`.
 > WARNING:
 >
 > 1. Relying on external sources adds a point of failure. If the external source doesn't work, your script won't either. Please make sure you are aware of the consequences.
-> 2. Make sure DnsControl only uses verified configuration if you want to use `FETCH`. For example, an attacker can send Pull Requests to your config repo, and have your CI test malicious configurations and make arbitrary HTTP requests. Therefore, `FETCH` must be explicitly enabled with flag `--allow-fetch` on DnsControl invocation.
+> 2. Make sure DNSControl only uses verified configuration if you want to use `FETCH`. For example, an attacker can send Pull Requests to your config repo, and have your CI test malicious configurations and make arbitrary HTTP requests. Therefore, `FETCH` must be explicitly enabled with flag `--allow-fetch` on DNSControl invocation.
 
 {% capture example %}
 ```js

docs/_functions/global/NewDnsProvider.md

@@ -12,7 +12,7 @@ A DSP stores a DNS zone's records and provides DNS service for the zone (i.e.
 answers on port 53 to queries related to the zone).
 
 * `name` must match the name of an entry in `creds.json`.
-* `type` specifies a valid DNS provider type identifier listed on the [provider page.]({{site.github.url}}/provider-list).
+* `type` specifies a valid DNS provider type identifier listed on the [provider page]({{site.github.url}}/provider-list).
   * Starting with v3.16, the type is optional. If it is absent, the `TYPE` field in `creds.json` is used instead. You can leave it out. (Thanks to JavaScript magic, you can leave it out even when there are more fields).
   * Starting with v4.0, specifying the type may be an error. Please add the `TYPE` field to `creds.json` and remove this parameter from `dnsconfig.js` to prepare.
 * `meta` is a way to send additional parameters to the provider.  It is optional and only certain providers use it.  See the [individual provider docs]({{site.github.url}}/provider-list) for details.

docs/_functions/global/NewRegistrar.md

@@ -12,7 +12,7 @@ A registrar maintains the domain's registration and delegation (i.e. the
 nameservers for the domain).  DNSControl only manages the delegation.
 
 * `name` must match the name of an entry in `creds.json`.
-* `type` specifies a valid DNS provider type identifier listed on the [provider page.]({{site.github.url}}/provider-list).
+* `type` specifies a valid DNS provider type identifier listed on the [provider page]({{site.github.url}}/provider-list).
   * Starting with v3.16, the type is optional. If it is absent, the `TYPE` field in `creds.json` is used instead. You can leave it out. (Thanks to JavaScript magic, you can leave it out even when there are more fields).
   * Starting with v4.0, specifying the type may be an error. Please add the `TYPE` field to `creds.json` and remove this parameter from `dnsconfig.js` to prepare.
 * `meta` is a way to send additional parameters to the provider.  It is optional and only certain providers use it.  See the [individual provider docs]({{site.github.url}}/provider-list) for details.

docs/_functions/global/PANIC.md

@@ -4,7 +4,7 @@ parameters:
   - message
 ---
 
-`PANIC` terminates the script and therefore DnsControl with an exit code of 1. This should be used if your script cannot gather enough information to generate records, for example when a HTTP request failed.
+`PANIC` terminates the script and therefore DNSControl with an exit code of 1. This should be used if your script cannot gather enough information to generate records, for example when a HTTP request failed.
 
 {% capture example %}
 ```js

docs/_functions/global/getConfiguredDomains.md

@@ -47,9 +47,9 @@ Example for adding DMARC report records:
 ```js
 var domains = getConfiguredDomains();
 for(i = 0; i < domains.length; i++) {
-	D_EXTEND("domain1.tld",
-		TXT(domains[i] + '._report._dmarc', 'v=DMARC1')
-	);
+    D_EXTEND("domain1.tld",
+        TXT(domains[i] + '._report._dmarc', 'v=DMARC1')
+    );
 }
 ```
 

docs/_functions/global/require.md

@@ -55,7 +55,7 @@ function includeK8Sdev() {
 
 {% include example.html content=example %}
 
-You can also use it to require json files and initialize variables with it:
+You can also use it to require JSON files and initialize variables with it:
 For Example:
 
 {% capture example %}

docs/_functions/global/require_glob.md

@@ -27,13 +27,13 @@ require_glob("./domains/", false);
 One more important thing to note: `require_glob()` is as smart as `require()` is. It loads files always relative to the JavaScript
 file where it's being executed in. Let's go with an example, as it describes it better:
 
-dnscontrol.js:
+`dnscontrol.js`:
 
 ```js
 require("domains/index.js");
 ```
 
-domains/index.js:
+`domains/index.js`:
 
 ```js
 require_glob("./user1/");

docs/_functions/record/R53_ZONE.md

@@ -8,8 +8,4 @@ R53_ZONE lets you specify the AWS Zone ID for an entire domain (D()) or a specif
 
 When used with D(), it sets the zone id of the domain. This can be used to differentiate between split horizon domains in public and private zones.
 
-When used with R53_ALIAS() it sets the required Route53 hosted zone id in a R53_ALIAS record. See [https://stackexchange.github.io/dnscontrol/js#R53_ALIAS](R53_ALIAS's documentation) for details.
-
-
-
-
+When used with R53_ALIAS() it sets the required Route53 hosted zone id in a R53_ALIAS record. See [R53_ALIAS's documentation](https://stackexchange.github.io/dnscontrol/js#R53_ALIAS) for details.