Improve documentation per feedback

Author: illusional

cwlgen/commandlinetool.py

@@ -45,6 +45,7 @@ def __init__(self, tool_id=None, base_command=None, label=None, doc=None,
         inputs (:class:`cwlgen.CommandInputParameter` objects),
         outputs (:class:`cwlgen.CommandOutputParameter` objects),
         arguments (:class:`cwlgen.CommandLineBinding` objects),
+        hints (any | :class:`cwlgen.Requirement` objects)
         and requirements (:class:`cwlgen.Requirement` objects)
         are stored in lists which are initialized empty.
         '''

cwlgen/common.py

@@ -72,7 +72,9 @@ def parse_type(param_type, requires_type=False):
 
 def get_type_dict(param_type):
     """
-    Convets
+    Generic method to the get dict for any of the valid param_type types,
+    ie:  CWLType | InputRecordSchema | InputEnumSchema | InputArraySchema | string
+       | array<CWLType | InputRecordSchema | InputEnumSchema | InputArraySchema | string>
     :param param_type:
     :type param_type: CWLType | InputRecordSchema | InputEnumSchema | InputArraySchema | string |
                 array<CWLType | InputRecordSchema | InputEnumSchema | InputArraySchema | string>

cwlgen/workflow.py

@@ -86,8 +86,8 @@ def __init__(self, workflow_id=None, label=None, doc=None, cwl_version='v1.0'):
         self.inputs = []            # list[InputParameter]
         self.outputs = []           # list[WorkflowOutputParameter]
         self.steps = []             # list[WorkflowStep]
-        self.requirements = []
-        self.hints = None
+        self.requirements = []      # list[Requirement]
+        self.hints = []             # list[Requirement]
         self._path = None
 
         self.ignore_attributes = ["inputs", "outputs"]