improving documentation for constructor