documentation fixes for new code