Big docs cleanup

... mostly in the risk area.