some updated incomplete docs #85