added base class docs, some tidying