update and move the model into docs
add file needed for future pull (rest of work is stashed)