documentation for #5 in README
documentation for #7 in README