updated requirements text
improvments to documentation