enrich documentation with specifications
clean up documentation structure
fine tuning documentation