more documentation updates and small improvements