docs

This is largely for capturing the initial requirements + user docs

The mainspec captures the intial spec for use cases and reequirements