The specs are the contract the engine is tested against, edited with the code, and read on GitHub. Making them documents would give them a genre they do not fit. The Reference map lists each one with a reason to read it.