diff --git a/docs/bids_app/config.md b/docs/bids_app/config.md
index 72f3545e..fe25c8fa 100644
--- a/docs/bids_app/config.md
+++ b/docs/bids_app/config.md
@@ -81,12 +81,16 @@ A mapping from the name of each ``analysis_level`` to the list of rules or files
 
 A dictionary of command-line parameters to make available as part of the BIDS app. Each item of the mapping is passed to [argparse's `add_argument` function](#argparse.ArgumentParser.add_argument). A number of default entries are present in a new snakebids project's config file that structure the BIDS app's CLI, but additional command-line arguments can be added as necessary.
 
-As in [`ArgumentParser.add_argument()`](#argparse.ArgumentParser.add_argument), `type` may be used to convert the argument to the specified type. It may be set to any builtin type, or the fully resolved path of a derived type. [`Path`](#pathlib.Path) may also be used directly:
+As in [`ArgumentParser.add_argument()`](#argparse.ArgumentParser.add_argument), `type` may be used to convert the argument to the specified type. It may be set to any type that can be serialized into yaml, for instance, `str`, `int`, `float`, and `boolean`.
 
 ```yaml
 parse_args:
+  --a-string:
+    help: args are string by default
   --a-path:
-    help: A path pointing to data needed for the pipeline
+    help: |
+      A path pointing to data needed for the pipeline. These are still converted
+      into strings, but are first resolved into absolute paths (see below)
     type: Path
   --another-path:
     help: This type annotation does the same thing as above
@@ -96,9 +100,7 @@ parse_args:
     type: float
 ```
 
-```{note}
-For object resolution to work, the last component of the module (i.e. following the final `.`) must be the name of a type, and all preceding components must be module and submodule names. So for instance, one cannot access a class method using this syntax.
-```
+When CLI parameters are used to collect paths, `type` should be set to [`Path`](#pathlib.Path) (or [`pathlib.Path`](#pathlib.Path)). These arguments will still be serialized as strings (since yaml doesn't have a path type), but snakebids will automatically resolve all arguments into absolute paths. This is important to prevent issues with snakebids and relative paths.
 
 
 ### `debug`