refactor to incorporate changes docs spec template

relates to #25

details:
* move doc source files to src dir
* generated output defaults to build dir
* git submodule in the docs-resources and remove the local copy in resources dir
* fix a bunch of typos in content

Signed-off-by: Kevin Broch <kbroch@rivosinc.com>