Amend links (in all .md files)

commands/types/dnscontrol.d.ts

@@ -356,10 +356,10 @@ declare function CNAME(name: string, target: string, ...modifiers: RecordModifie
 declare function DS(name: string, keytag: number, algorithm: number, digesttype: number, digest: string, ...modifiers: RecordModifier[]): DomainModifier;
 
 /**
- * DefaultTTL sets the TTL for all subsequent records following it in a domain that do not explicitly set one with [`TTL`](../record/TTL.md). If neither `DefaultTTL` or `TTL` exist for a record,
- * the record will inherit the DNSControl global internal default of 300 seconds. See also [`DEFAULTS`](../global/DEFAULTS.md) to override the internal defaults.
+ * DefaultTTL sets the TTL for all subsequent records following it in a domain that do not explicitly set one with [`TTL`](../record_modifier_functions/TTL.md). If neither `DefaultTTL` or `TTL` exist for a record,
+ * the record will inherit the DNSControl global internal default of 300 seconds. See also [`DEFAULTS`](../top_level_functions/DEFAULTS.md) to override the internal defaults.
  * 
- * NS records are currently a special case, and do not inherit from `DefaultTTL`. See [`NAMESERVER_TTL`](../domain/NAMESERVER_TTL.md) to set a default TTL for all NS records.
+ * NS records are currently a special case, and do not inherit from `DefaultTTL`. See [`NAMESERVER_TTL`](NAMESERVER_TTL.md) to set a default TTL for all NS records.
  * 
  * ```javascript
  * D('example.com', REGISTRAR, DnsProvider('R53'),
@@ -369,7 +369,7 @@ declare function DS(name: string, keytag: number, algorithm: number, digesttype:
  * );
  * ```
  * 
- * The DefaultTTL duration is the same format as [`TTL`](../record/TTL.md), an integer number of seconds
+ * The DefaultTTL duration is the same format as [`TTL`](../record_modifier_functions/TTL.md), an integer number of seconds
  * or a string with a unit such as `'4d'`.
  * 
  * @see https://dnscontrol.org/js#DefaultTTL
@@ -1159,7 +1159,7 @@ declare const PURGE: DomainModifier;
  * * Most providers automatically generate SOA records.  They will ignore any `SOA()` statements.
  * * The mbox field should not be set to a real email address unless you love spam and hate your privacy.
  * 
- * There is more info about `SOA` in the documentation for the [BIND provider](../../providers/bind.md).
+ * There is more info about `SOA` in the documentation for the [BIND provider](../../service_providers/providers/bind.md).
  * 
  * @see https://dnscontrol.org/js#SOA
  */
@@ -2302,10 +2302,10 @@ declare function IP(ip: string): number;
  * 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](../../providers.md).
+ * * `type` specifies a valid DNS provider type identifier listed on the [provider page](../../service_providers/providers.md).
  *   * Starting with [v3.16](../../v316.md), 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](../../providers.md) for details.
+ * * `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](../../service_providers/providers.md) for details.
  * 
  * This function will return an opaque string that should be assigned to a variable name for use in [D](D.md) directives.
  * 
@@ -2341,10 +2341,10 @@ declare function NewDnsProvider(name: string, type?: string, meta?: object): str
  * 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](../../providers.md).
+ * * `type` specifies a valid DNS provider type identifier listed on the [provider page](../../service_providers/providers.md).
  *   * Starting with [v3.16](../../v316.md), 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](../../providers.md) for details.
+ * * `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](../../service_providers/providers.md) for details.
  * 
  * This function will return an opaque string that should be assigned to a variable name for use in [D](D.md) directives.
  * 

documentation/adding-new-rtypes.md

@@ -79,9 +79,9 @@ popd
     func matrixData() *FeatureMatrix {
         const (
             ...
-            DomainModifierCaa    = "[`CAA`](functions/domain/CAA.md)"
-    +       DomainModifierFoo    = "[`FOO`](functions/domain/FOO.md)"
-            DomainModifierLoc    = "[`LOC`](functions/domain/LOC.md)"
+            DomainModifierCaa    = "[`CAA`](language_reference/domain_modifier_functions/CAA.md)"
+    +       DomainModifierFoo    = "[`FOO`](language_reference/domain_modifier_functions/FOO.md)"
+            DomainModifierLoc    = "[`LOC`](language_reference/domain_modifier_functions/LOC.md)"
             ...
         )
         matrix := &FeatureMatrix{
@@ -153,7 +153,7 @@ example we removed `providers.CanUseCAA` from the
 
 Add a function to `pkg/js/helpers.js` for the new record type. This
 is the JavaScript file that defines `dnsconfig.js`'s functions like
-[`A()`](functions/domain/A.md) and [`MX()`](functions/domain/MX.md). Look at the definition of `A`, `MX` and `CAA` for good
+[`A()`](language_reference/domain_modifier_functions/A.md) and [`MX()`](language_reference/domain_modifier_functions/MX.md). Look at the definition of `A`, `MX` and `CAA` for good
 examples to use as a base.
 
 Please add the function alphabetically with the others. Also, please run
@@ -306,24 +306,24 @@ Add the new file `FOO.md` to the documentation table of contents [`documentation
 ...
 * Domain Modifiers
 ...
-    * [DnsProvider](functions/domain/DnsProvider.md)
-+   * [FOO](functions/domain/FOO.md)
-    * [FRAME](functions/domain/FRAME.md)
+    * [DnsProvider](language_reference/domain_modifier_functions/DnsProvider.md)
++   * [FOO](language_reference/domain_modifier_functions/FOO.md)
+    * [FRAME](language_reference/domain_modifier_functions/FRAME.md)
 ...
     * Service Provider specific
 ...
         * ClouDNS
-            * [CLOUDNS_WR](functions/domain/CLOUDNS_WR.md)
+            * [CLOUDNS_WR](language_reference/domain_modifier_functions/service_provider_specific/ClouDNS/CLOUDNS_WR.md)
 +       * ASDF
-+           * [NINJA_RECORD](function/domain/FOO_NINJA.md)
++           * [NINJA_RECORD](language_reference/domain_modifier_functions/service_provider_specific/XYZ/FOO_NINJA.md)
         * NS1
-            * [NS1_URLFWD](functions/domain/NS1_URLFWD.md)
+            * [NS1_URLFWD](language_reference/domain_modifier_functions/service_provider_specific/NS1/NS1_URLFWD.md)
 ...
 * Record Modifiers
 ...
-    * [DMARC_BUILDER](functions/record/DMARC_BUILDER.md)
-+   * [FOO_HELPER](functions/record/FOO_HELPER.md)
-    * [SPF_BUILDER](functions/record/SPF_BUILDER.md)
+    * [DMARC_BUILDER](language_reference/record_modifier_functions/DMARC_BUILDER.md)
++   * [FOO_HELPER](language_reference/record_modifier_functions/FOO_HELPER.md)
+    * [SPF_BUILDER](language_reference/record_modifier_functions/SPF_BUILDER.md)
 ...
 ```
 {% endcode %}

documentation/bug-triage.md

@@ -2,7 +2,7 @@
 
 If an issue is related to a particular provider, assign it to
 the person responsible for the provider, as listed in
-[Providers](providers.md)'s "Maintainers of
+[Providers](service_providers/providers.md)'s "Maintainers of
 contributed providers".
 
 Otherwise leave it unassigned until someone grabs it.
@@ -27,7 +27,7 @@ priority:
 1. Respond to the issue with the message below
 1. Close the issue
 
-The [Providers](providers.md) page is generated
+The [Providers](service_providers/providers.md) page is generated
 automatically from all the issues tagged `provider-request`:
 
 1. "Requested providers: state=closed, tagged `provider-request`

documentation/byo-secrets.md

@@ -155,7 +155,7 @@ HEXONET_UID: test.user
 ```
 
 {% hint style="info" %}
-**NOTE**: The above credentials are [known to the public](providers/hexonet.md).
+**NOTE**: The above credentials are [known to the public](service_providers/providers/hexonet.md).
 {% endhint %}
 
 # Caveats

documentation/code-tricks.md

@@ -4,9 +4,9 @@ Problem: It is difficult to get CAA and other records exactly right.
 
 Solution: Use a "builder" to construct it for you.
 
-* [CAA Builder](functions/record/CAA_BUILDER.md)
-* [DMARC Builder](functions/record/DMARC_BUILDER.md)
-* [SPF Optimizer](functions/record/SPF_BUILDER.md)
+* [CAA Builder](language_reference/record_modifier_functions/CAA_BUILDER.md)
+* [DMARC Builder](language_reference/record_modifier_functions/DMARC_BUILDER.md)
+* [SPF Optimizer](language_reference/record_modifier_functions/SPF_BUILDER.md)
 
 # Repeat records in many domains (macros)
 

documentation/creds-json.md

@@ -167,7 +167,7 @@ invalid. Perhaps you meant to specify a `-` on a command-line tool?
 
 The fix is to change the `TYPE` subkey entry in `creds.json` from `-` to
 a valid service provider identifier, as listed
-in [the service provider list](providers.md).
+in [the service provider list](service_providers/providers.md).
 
 
 ## Using a different file name

documentation/examples.md

@@ -49,7 +49,7 @@ D('example.com', REG, DnsProvider('R53'),
 {% endcode %}
 
 {% hint style="info" %}
-**NOTE**: The [`IP()`](functions/global/IP.md) function doesn't currently support IPv6 (PRs welcome!).  IPv6 addresses are strings.
+**NOTE**: The [`IP()`](language_reference/top_level_functions/IP.md) function doesn't currently support IPv6 (PRs welcome!).  IPv6 addresses are strings.
 {% endhint %}
 {% code title="dnsconfig.js" %}
 ```javascript

documentation/getting-started.md

@@ -99,7 +99,7 @@ D('example.com', REG_NONE, DnsProvider(DNS_BIND),
 ```
 {% endcode %}
 
-Modify this file to match your particular providers and domains. See [the DNSConfig docs](language_reference/JavaScript_DSL.md) and [the provider docs](providers.md) for more details.
+Modify this file to match your particular providers and domains. See [the DNSConfig docs](language_reference/JavaScript_DSL.md) and [the provider docs](service_providers/providers.md) for more details.
 
 Create a file called `creds.json` for storing provider configurations (API tokens and other account information).
 For example, to use both name.com and Cloudflare, you would have:
@@ -292,7 +292,7 @@ $TTL 300
 ```
 
 You can change the "DEFAULT_NOT_SET" text by following the documentation
-for the [BIND provider](providers/bind.md) to set
+for the [BIND provider](service_providers/providers/bind.md) to set
 the "master" and "mbox" settings.  Try that now.
 
 
@@ -303,7 +303,7 @@ a real domain (or a test domain if you have one).
 
 Set up the provider:  Add the providers's definition to `dnsconfig.js`
 and list any credentials in `creds.json`.  Each provider is different.
-See [the provider docs](providers.md) for
+See [the provider docs](service_providers/providers.md) for
 specifics.
 
 Edit the domain: Add the `D()` entry for the domain, or repurpose

documentation/index.md

@@ -4,21 +4,21 @@
 
 # Try It
 
-Want to jump right in? Follow our [quick start tutorial](getting-started.md) on a new domain or [migrate](migrating.md) an existing one. Read the [language spec](02_language_reference/JavaScript_DSL.md) for more info.
+Want to jump right in? Follow our [quick start tutorial](getting-started.md) on a new domain or [migrate](migrating.md) an existing one. Read the [language spec](language_reference/JavaScript_DSL.md) for more info.
 
 # Use It
 
-Take advantage of the advanced features. Use macros and variables for easier updates. Upload your zones to [multiple DNS providers](providers.md).
+Take advantage of the advanced features. Use macros and variables for easier updates. Upload your zones to [multiple DNS providers](service_providers/providers.md).
 
 {% hint style="success" %}
 * Maintain your DNS data as a high-level DS, with macros, and variables for easier updates.
 * Super extensible! Plug-in architecture makes adding new DNS providers and Registrars easy!
 * Eliminate vendor lock-in. Switch DNS providers easily, any time, with full fidelity.
 * Reduce points of failure: Easily maintain dual DNS providers and easily drop one that is down.
-* Supports 35+ [DNS Providers](providers.md) including [BIND](providers/bind.md), [AWS Route 53](providers/route53.md), [Google DNS](providers/gcloud.md), and [name.com](providers/namedotcom.md).
+* Supports 35+ [DNS Providers](service_providers/providers.md) including [BIND](service_providers/providers/bind.md), [AWS Route 53](service_providers/providers/route53.md), [Google DNS](service_providers/providers/gcloud.md), and [name.com](service_providers/providers/namedotcom.md).
 * [Apply CI/CD principles](ci-cd-gitlab.md) to DNS: Unit-tests, system-tests, automated deployment.
 * All the benefits of Git (or any VCS) for your DNS zone data. View history. Accept PRs.
-* Optimize DNS with [SPF optimizer](functions/record/SPF_BUILDER.md). Detect too many lookups. Flatten includes.
+* Optimize DNS with [SPF optimizer](language_reference/record_modifier_functions/SPF_BUILDER.md). Detect too many lookups. Flatten includes.
 * Runs on Linux, Windows, Mac, or any operating system supported by Go.
 * Enable/disable Cloudflare proxying (the "orange cloud" button) directly from your DNSControl files.
 * [Assign an IP address to a constant](examples.md#variables-for-common-ip-addresses) and use the variable name throughout the configuration. Need to change the IP address globally? Just change the variable and "recompile".

documentation/language_reference/domain_modifier_functions/SOA.md

@@ -39,4 +39,4 @@ when you are making it easier for spammers how to find you.
 * Most providers automatically generate SOA records.  They will ignore any `SOA()` statements.
 * The mbox field should not be set to a real email address unless you love spam and hate your privacy.
 
-There is more info about `SOA` in the documentation for the [BIND provider](../../providers/bind.md).
+There is more info about `SOA` in the documentation for the [BIND provider](../../service_providers/providers/bind.md).

documentation/language_reference/top_level_functions/NewDnsProvider.md

@@ -16,10 +16,10 @@ 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](../../providers.md).
+* `type` specifies a valid DNS provider type identifier listed on the [provider page](../../service_providers/providers.md).
   * Starting with [v3.16](../../v316.md), 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](../../providers.md) for details.
+* `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](../../service_providers/providers.md) for details.
 
 This function will return an opaque string that should be assigned to a variable name for use in [D](D.md) directives.
 

documentation/language_reference/top_level_functions/NewRegistrar.md

@@ -16,10 +16,10 @@ 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](../../providers.md).
+* `type` specifies a valid DNS provider type identifier listed on the [provider page](../../service_providers/providers.md).
   * Starting with [v3.16](../../v316.md), 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](../../providers.md) for details.
+* `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](../../service_providers/providers.md) for details.
 
 This function will return an opaque string that should be assigned to a variable name for use in [D](D.md) directives.
 

documentation/nameservers.md

@@ -248,7 +248,7 @@ a notified if the delegation diverges.
 Why?
 Sometimes you just want to know if something changes!
 
-See the [DNS-over-HTTPS Provider](providers/dnsoverhttps.md) documentation for more info.
+See the [DNS-over-HTTPS Provider](service_providers/providers/dnsoverhttps.md) documentation for more info.
 
 {% code title="dnsconfig.js" %}
 ```javascript