many additions to documentation