DOCS: [DEFAULTS] General improvements
@@ -6,18 +6,37 @@ parameter_types:
"modifiers...": RecordModifier[]
---
-`DEFAULTS` allows you to declare a set of default arguments to apply to all subsequent domains. Subsequent calls to [D](D.md) will have these
+`DEFAULTS` allows you to declare a set of default arguments to apply to all subsequent domains. Subsequent calls to [`D`](D.md) will have these
arguments passed as if they were the first modifiers in the argument list.
+## Example
+
+We want to create backup zone files for all domains, but not actually register them. Also create a [`DefaultTTL`](../domain/DefaultTTL.md).
+The domain `example.com` will have the defaults set.
+
```javascript
var COMMON = NewDnsProvider("foo");
-// we want to create backup zone files for all domains, but not actually register them.
-// also create a default TTL
-DEFAULTS( DnsProvider(COMMON,0), DefaultTTL(1000));
+DEFAULTS(
+ DnsProvider(COMMON, 0),
+ DefaultTTL('1d')
+);
+
+D("example.com",
+ REGISTRAR,
+ DnsProvider("R53"),
+ A("@","1.2.3.4")
+);
+```
-D("example.com", REGISTRAR, DnsProvider("R53"), A("@","1.2.3.4")); // this domain will have the defaults set.
+If you want to clear the defaults, you can do the following.
+The domain `example2.com` will **not** have the defaults set.
-// clear defaults
+```javascript
DEFAULTS();
-D("example2.com", REGISTRAR, DnsProvider("R53"), A("@","1.2.3.4")); // this domain will not have the previous defaults.
+
+D("example2.com",
+ REGISTRAR,
+ DnsProvider("R53"),
+ A("@","1.2.3.4")
+);
```
