more documentation improvements