diff --git a/argparse_dataclass.py b/argparse_dataclass.py
index 4a5baf3..c530f09 100644
--- a/argparse_dataclass.py
+++ b/argparse_dataclass.py
@@ -118,6 +118,20 @@
     >>> print(parser.parse_args(["--name", "john doe"]))
     Options(name='John Doe')
 
+Parsing a list of values:
+
+.. code-block:: pycon
+
+    >>> from dataclasses import dataclass, field
+    >>> from argparse_dataclass import ArgumentParser
+    >>> @dataclass
+    ... class Options:
+    ...     names: list[str] = field(metadata=dict(type=str, nargs="+"))
+    ...
+    >>> parser = ArgumentParser(Options)
+    >>> print(parser.parse_args(["--names", "john", "jane"]))
+    Options(names=['john', 'jane'])
+
 Configuring a flag to have a default value of True:
 
 .. code-block:: pycon