Addressed comments

Author: romain-intel

metaflow/client/core.py

@@ -1672,7 +1672,7 @@ def control_tasks(self, *tags: str) -> Iterator[Task]:
         Yields
         ------
         Task
-            Control Task object for this step
+            Control Task objects for this step
         """
         children = super(Step, self).__iter__()
         for child in children:

metaflow/decorators.py

@@ -549,6 +549,11 @@ def _init_step_decorators(flow, graph, environment, flow_datastore, logger):
 
 FlowSpecDerived = TypeVar("FlowSpecDerived", bound=FlowSpec)
 
+# The StepFlag is a "fake" input item to be able to distinguish
+# callables and those that have had a `@step` decorator on them. This enables us
+# to check the ordering of decorators (ie: put @step first) with the type
+# system. There should be a better way to do this with a more flexible type
+# system but this is what works for now with the Python type system
 StepFlag = NewType("StepFlag", bool)
 
 

stubs/setup.py

@@ -7,9 +7,7 @@
     include_package_data=True,
     name="metaflow-stubs",
     version=version,
-    description="Metaflow: More Data Science, Less Engineering",
-    long_description=open("../README.md").read(),
-    long_description_content_type="text/markdown",
+    description="Metaflow Stubs: Stubs for the metaflow package",
     author="Metaflow Developers",
     author_email="[email protected]",
     license="Apache Software License",
@@ -26,6 +24,7 @@
         "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
     ],
     project_urls={
         "Source": "https://github.com/Netflix/metaflow",