minor docstring/comment changes and poly_area now expects ordered vertices