a bit of a glossary in the __init__ docstring