Add a design document

[lachlangrose]

@RoyThomsonMonash could you add a document explaining the design choices for the projectfile? Maybe a checklist of things that a contributor should do prior to submitting a pull request.