you should add examples, otherwise the types are undocumented except in code.