add minor doc strings
a first intro sentence :-)