Recommend the PlantUML for GitHub extension and use live plantuml blocks
Add pages on artifacts, traceability and diagrams