documentation updates and bug fix