DOC : add documentation to Polygon methods

closes #3035
I think it would be:
```
:class:`Path`
```
or whatever the resolvable name would be at that point in the code.