fleshing out arch diagram document
adding bits about planning docs to readme