added very useful documentation to README