minimal rest fixes and documentation