updating the model, including the doc params
fixup the model update
initial commit of application states and associated test code
stubbing out the needed rs api
updating the README to reflect suggested usage