improve docs on redrawing and keys