Document finder module and options

shared/finder/default.nix

@@ -1,3 +1,11 @@
+# Webapp to read downloaded manga.  There is no public deployment.
+#
+# finder uses a containerised elasticsearch database, and requires read access
+# to the filesystem where manga is stored.  It does not manage the manga, only
+# provides an interface to search and read.
+#
+# The database can be recreated from the manga files, so this module does not
+# include a backup script.
 { config, lib, ... }:
 
 with lib;

shared/finder/options.nix

@@ -4,10 +4,43 @@ with lib;
 
 {
   options.nixfiles.finder = {
-    enable = mkOption { type = types.bool; default = false; };
-    image = mkOption { type = types.str; };
-    port = mkOption { type = types.int; default = 44986; };
-    esTag = mkOption { type = types.str; default = "8.0.0"; };
-    mangaDir = mkOption { type = types.path; };
+    enable = mkOption {
+      type = types.bool;
+      default = false;
+      description = mdDoc ''
+        Enable the `finder` module.
+      '';
+    };
+
+    image = mkOption {
+      type = types.str;
+      description = mdDoc ''
+        Container image to use.
+      '';
+    };
+
+    port = mkOption {
+      type = types.int;
+      default = 44986;
+      description = mdDoc ''
+        Port (on 127.0.0.1) to expose the finder service on.
+      '';
+    };
+
+    esTag = mkOption {
+      type = types.str;
+      default = "8.0.0";
+      description = mdDoc ''
+        Tag to use of the `elasticsearch` container image.
+      '';
+    };
+
+    mangaDir = mkOption {
+      type = types.path;
+      example = "/mnt/nas/manga";
+      description = mdDoc ''
+        Directory to serve manga files from.
+      '';
+    };
   };
 }