add some documentation -- shocking I know