add documentation fixes from #1285