addressing @antgonza's comments

Author: josenavas

qiita_db/test/test_processing_job.py

@@ -458,8 +458,12 @@ def test_complete_success(self):
         alljobs = set(self._get_all_job_ids())
 
         job.complete(True, artifacts_data=artifacts_data)
-        # The validator job spawn blocks this job in running state until
-        # the validator job is completed
+        # When completing the previous job, it creates a new job that needs
+        # to validate the BIOM table that is being added as new artifact.
+        # Hence, this job is still in running state until the validation job
+        # is completed. Note that this is tested by making sure that the status
+        # of this job is running, and that we have one more job than before
+        # (see assertEqual with len of all jobs)
         self.assertEqual(job.status, 'running')
 
         obsjobs = set(self._get_all_job_ids())