doc clean-up and format name changes

~~**NOT READY FOR MERGE**~~
Can you give another example of what you might store in this format? e.g., a substitution matrix or similarity matrix