add the doc strings

to make myself remember the details of the classed, add the doc strings.