DOC : add documentation to Polygon methods

closes #3035
Merge pull request #3123 from tacaswell/polygon_doc

DOC : add documentation to Polygon methods