DOC : add documentation to Polygon methods

closes #3035
fixed and forced