more user doc and namespace doc'ed in types