enrich documentation with specifications
clean up documentation structure