Add test descriptions

databuild/orchestrator.rs

@@ -153,6 +153,43 @@ impl<B: BELStorage + Debug> Orchestrator<B> {
 
 #[cfg(test)]
 mod tests {
+    mod poll_jobs {
+        // Use case: we find a job that has completed, BEL should be written with appropriate event
+        //  (both for success and fail cases)
+        #[test]
+        fn test_job_completion_events() {
+            // TODO
+        }
+
+        //Use case: a job has written new stdout, it should produce a new heartbeat event in the BEL
+        // TODO - we should come back here later and ensure we have a minimum heartbeat period
+        #[test]
+        fn test_heartbeat_from_stdout() {
+            // TODO
+        }
+    }
+
+    mod poll_wants {
+        // Use case: Empty schedulable wants is a valid case, and should create no new jobs.
+        #[test]
+        fn test_empty_wants_noop() {
+            // TODO
+        }
+
+        // Use case: Some schedulable wants with jobs that can be matched should launch those jobs
+        //  (but in this case using a noop/mock child process)
+        #[test]
+        fn test_schedulable_wants_should_schedule() {
+            // TODO
+        }
+
+        // Use case: A schedulable want that can't be matched to a job should return an error
+        #[test]
+        fn test_schedulable_want_no_matching_job() {
+            // TODO
+        }
+    }
+
     mod want_group {
         use super::super::*;
         use crate::build_event_log::MemoryBELStorage;