more docs, refs #30