adding more verbose comments on how grids are calculated into the comment page. Updating documentation to match