Split src into 3 directories

[tclune]

Immediate thought is to have 3 folders: use_cases, examples, and documents.

Might be better to just have actual documents in the top dir: requirements.md, specs.md, ...