added a doc string to schema_gen.py and a note in models.py

refs SPOT-624