add some links, formatting, a few notes