some comments and removed the REVIEW doc from public view

.gitignore

@@ -4,3 +4,4 @@
 schemato_config.py
 nohup.out
 *.smt
+REVIEW.rst

schemato/schemato.py

@@ -38,7 +38,6 @@ def import_module(name):
             v_instance = getattr(v_package, module_string.split('.')[-1])(self.graph, self.doc_lines, url=self.url)
             self.validators.append(v_instance)
 
-
     def validate(self):
         results = []
 

schemato/validator.py

@@ -56,7 +56,6 @@ def validate(self):
 
     def _check_triple(self, (subj, pred, obj)):
         """compare triple to ontology, return error or None"""
-        # don't bother with special 'type' triples
         if self._field_name_from_uri(pred) in ['type', 'item', 'first', 'rest']:
             log.info("ignoring triple with predicate '%s'" % self._field_name_from_uri(pred))
             return
@@ -74,21 +73,18 @@ def _check_triple(self, (subj, pred, obj)):
         if type(instanceof) == rt.URIRef:
             instanceof = self._expand_qname(instanceof)
 
-        # this method should differentiate between an "error" and a "warning"
-        # since not all issues with an implementation worth telling
-        # the user about are actual "errors", just things to keep in mind
         class_invalid = self._validate_class(instanceof)
         if class_invalid:
             log.warning("Invalid class %s" % instanceof)
             return class_invalid
         # TODO - the above sometimes fails when a single object has more than one
         # rdfa type (eg <span property="schema:creator rnews:creator" typeof="schema:Person rnews:Person">
         # Graph chooses the type in an arbitrary order, so it's unreliable
+        # eg: http://semanticweb.com/the-impact-of-rdfa_b35003
 
         classes = self._superclasses_for_subject(self.graph, instanceof)
         classes.append(instanceof)
 
-        # is this attribute a valid member of the class or superclasses?
         member_invalid = self._validate_member(pred, classes, instanceof)
         if member_invalid:
             log.warning("Invalid member of class")