add comments, include recipes.  cleanup validation.