Reorganize so we have an appendices section as well. More work on intro/overview
Move JSON/YAML docs into appendicies. Fix some broken links