documentation improvements
revision update