generate docs, move ops out of the type, rename schema