[DOC] Small changes

* fix wrong param description
* add comment for constructor assignment (as in Point, Rectangle ...)