introduce docs standards

[Jonathan-Zollinger]

Introduce docs strategy such that

• users know what docs are required when they contribute to the codebase
• can tests validate that docs are up to date or sufficient in any way?
• docs are published to github pages