updated docs and little reorg for editable-rest-record and rest-record