diff --git a/docs/markdown/D.md b/docs/markdown/D.md
index 501f1db50..7ade5c85d 100644
--- a/docs/markdown/D.md
+++ b/docs/markdown/D.md
@@ -49,7 +49,8 @@ my_dep = declare_dependency(
 )
 ```
 
-Accepted D specific parameters are `d_module_versions` and `d_import_dirs`.
+Accepted D specific parameters are `d_module_versions` and `d_import_dirs`
+(DMD `-J` switch).
 
 ## Using embedded unittests
 
diff --git a/docs/yaml/functions/declare_dependency.yaml b/docs/yaml/functions/declare_dependency.yaml
index f043d1d27..bcc834328 100644
--- a/docs/yaml/functions/declare_dependency.yaml
+++ b/docs/yaml/functions/declare_dependency.yaml
@@ -57,3 +57,17 @@ kwargs:
       this is meant to be used
       in subprojects where special variables would be provided via cmake or
       pkg-config. *since 0.56.0* it can also be a list of `'key=value'` strings.
+
+  d_module_versions:
+    type: str | list[str]
+    since: 0.62.0
+    description: |
+      a string or a list of strings,
+      the D versions to add during the compilation of D source files
+
+  d_import_dirs:
+    type: list[inc | str]
+    since: 0.62.0
+    description: |
+      the directories to add to the string search path (i.e. `-J` switch for DMD).
+      Must be [[@inc]] objects or plain strings.