note that exceptions are a slow way to compute sqrt
other minor fixes to that doc section