Merge pull request #1425 from spotify/erikbern-1424

positional parameter qualification
spotify · Nov 25, 2015 · 2db757a · 2db757a
2 parents b9e105c + 1409580
commit 2db757a
Showing 1 changed file with 2 additions and 3 deletions.
diff --git a/luigi/parameter.py b/luigi/parameter.py
@@ -129,9 +129,8 @@ def __init__(self, default=_no_value, is_global=False, significant=True, descrip
                                  default value for this parameter. DEPRECATED.
                                  Default: ``None``.
         :param bool positional: If true, you can set the argument as a
-                                positional argument. Generally we recommend ``positional=False``
-                                as positional arguments become very tricky when
-                                you have inheritance and whatnot.
+                                positional argument. It's true by default but we recommend
+                                ``positional=False`` for abstract base classes and similar cases.
         :param bool always_in_help: For the --help option in the command line
                                     parsing. Set true to always show in --help.
         """