Thinking about improving the documentation of our own database, we thought it would be nice to add the table definition to its docstring. We do this using a decorator on the table definition somewhat like this:

def docappend(cls):
    cls.__doc__ += cls.definition
    return cls

@docappend
@schema
class MyTable(dj.Imported):
    .....

To us, it seemed like a minor but useful feature to include in a future version of datajoint.