merge the contrib and appendix pages
add new intro section
fix all the links