documentation changes

some text moved to README