Added comment attempting to describe intent of (possibly) overly complex code.

git-svn-id: https://svn.apache.org/repos/asf/continuum/trunk@1675846 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/continuum-core/src/main/java/org/apache/maven/continuum/core/action/CreateBuildProjectTaskAction.java b/continuum-core/src/main/java/org/apache/maven/continuum/core/action/CreateBuildProjectTaskAction.java
index 7479ecd..5f3ee8e 100644
--- a/continuum-core/src/main/java/org/apache/maven/continuum/core/action/CreateBuildProjectTaskAction.java
+++ b/continuum-core/src/main/java/org/apache/maven/continuum/core/action/CreateBuildProjectTaskAction.java
@@ -81,6 +81,17 @@
 
             try
             {
+                /**
+                 * The following can (and probably should) be simplified to:
+                 *
+                 * If project is building in executor or its state is UPDATING:
+                 *   * Skip the project and log it
+                 *
+                 * If project state is not in { NEW, CHECKEDOUT, OK, FAILED, ERROR }:
+                 *   * Set the project's state to ERROR
+                 *
+                 * Lastly, record the project's original state and add it to the list of projects to build
+                 */
                 if ( project.getState() != ContinuumProjectState.NEW &&
                     project.getState() != ContinuumProjectState.CHECKEDOUT &&
                     project.getState() != ContinuumProjectState.OK &&