Document api_classes

I don't know why `BaseDefinition.path` is exposed as a public attribute so I didn't document it.  Probably you should rename it to `_path` or something.