put example usage in docstring
(#590)
put some info into WFIRST module docstring
(#590)