update documentation for #2