suggested corrections for the doc to compile