doc updates 1

Please double-check that additions are accurate before merging.