write up some missing documentation