documentation improvements and nitpicking on tests