add outline to discussion
add some old changes to intro
add misc code appendix

mostly links to github