misc documentation improvements