grid and meta docstrings

cc @theengineear @etpinard 
confusing about the exception? or the way that it was laid out?