DOC : add documentation to Polygon methods

closes #3035
Nit-picking: here and below, it should be plural, "coordinates".