treewide: use mdDoc for descriptions

Enable markdown syntax (instead of docbook) for descriptions.
This only affects external doc tooling that renders the descriptions.

test/lib/shellcheck-services.nix

@@ -5,7 +5,7 @@ let
     enable = mkOption {
       type = types.bool;
       default = false;
-      description = ''
+      description = mdDoc ''
         Whether to shellcheck services during system build time.
       '';
     };
@@ -13,14 +13,14 @@ let
     sourcePrefix = mkOption {
       type = with types; nullOr str;
       default = null;
-      description = ''
+      description = mdDoc ''
         The definition source path prefix of services to include in the shellcheck.
       '';
     };
 
     runShellcheck = mkOption {
       readOnly = true;
-      description = ''
+      description = mdDoc ''
         A derivation that runs shellcheck on all bash scripts included
         in nix-bitcoin services.
       '';

test/lib/test-lib.nix

@@ -10,7 +10,7 @@ with lib;
       noConnections = mkOption {
         type = types.bool;
         default = !config.test.container.enableWAN;
-        description = ''
+        description = mdDoc ''
           Whether services should be configured to not connect to external hosts.
           This can silence some warnings while running the test in an offline environment.
         '';
@@ -18,9 +18,9 @@ with lib;
       data = mkOption {
         type = types.attrs;
         default = {};
-        description = ''
+        description = mdDoc ''
           Attrs that are available in the Python test script under the global
-          dictionary variable 'test_data'. The data is exported via JSON.
+          dictionary variable {var}`test_data`. The data is exported via JSON.
         '';
       };
       extraTestScript = mkOption {