changes to documentation

after preliminary submission