diff --git a/node/config/doc_gen.go b/node/config/doc_gen.go
index 55fc7b2da..e5a1f98fd 100644
--- a/node/config/doc_gen.go
+++ b/node/config/doc_gen.go
@@ -130,14 +130,23 @@ and storage providers`,
 			Name: "RootDir",
 			Type: "string",
 
-			Comment: `Default value: $LOTUS_MARKETS_PATH/dagstore (split deployment) or
-$LOTUS_MINER_PATH/dagstore (monolith deployment)`,
+			Comment: `Path to the dagstore root directory. This directory contains three
+subdirectories, which can be symlinked to alternative locations if
+need be:
+- ./transients: caches unsealed deals that have been fetched from the
+storage subsystem for serving retrievals.
+- ./indices: stores shard indices.
+- ./datastore: holds the KV store tracking the state of every shard
+known to the DAG store.
+Default value: <LOTUS_MARKETS_PATH>/dagstore (split deployment) or
+<LOTUS_MINER_PATH>/dagstore (monolith deployment)`,
 		},
 		{
 			Name: "MaxConcurrentIndex",
 			Type: "int",
 
 			Comment: `The maximum amount of indexing jobs that can run simultaneously.
+0 means unlimited.
 Default value: 5.`,
 		},
 		{
@@ -145,8 +154,8 @@ Default value: 5.`,
 			Type: "int",
 
 			Comment: `The maximum amount of unsealed deals that can be fetched simultaneously
-from the storage subsystem.
-Default value: 0.`,
+from the storage subsystem. 0 means unlimited.
+Default value: 0 (unlimited).`,
 		},
 		{
 			Name: "MaxConcurrencyStorageCalls",