#249 review markups from @stof on pull req #250