more bits of docs

Originally filed as #249, squashed and tuned by @larsrh.
run gen-type-class