add extra documentation and remove warning #635

Closed mgonc closed 6 years ago