Add docs to contract model
#1850

toolness wants to merge 1824-document-contract-model into develop

We do not currently have an analysis of these two commits