This commit adds documentation around project direction and conventions.
Additionally, I've added doc8 checks to make sure or .rst and .txt files
in this repository follow good conventions, and fixed a check related to
graphviz external .dot files.
Change-Id: I1b73b3839b86198f3d56587ca3fb2644dc231f00