Add comments #919

Signed-off-by: Jono Yang <[email protected]>

Author: JonoYang

src/scancode/resource.py

@@ -173,6 +173,7 @@ def __init__(self, location, resource_class=None,
         # True if this codebase root is a file or an empty directory.
         self.has_single_resource = bool(self.is_file or not os.listdir(location))
 
+        # Set up caching, summary, timing, and error info
         self._setup_essentials(temp_dir, max_in_memory)
 
         # finally walk the location and populate
@@ -1068,6 +1069,14 @@ def __init__(self, json_scan_location, plugin_attributes, temp_dir=scancode_temp
         self._populate(plugin_attributes)
 
     def _populate(self, plugin_attributes):
+        """
+        Populate this codebase with Resource objects.
+
+        Population is done by loading JSON scan results and creating new
+        Resources for each result.
+
+        We assume that the input JSON scan results are in top-down order.
+        """
         # Load scan data
         with open(self.json_scan_location, 'rb') as f:
             scan_data = json.load(f, object_pairs_hook=OrderedDict)