clarify docs a little more, add links