changed the doc for diagonal slightly, no major update