move some docstrings from code to README.md