DOC: fix api documentation for accessors
Closes #9599

With this I updated the docs (assign docstring included in API, and the cat/str/dt accessors now documented correctly).

The Categorical page without methods and attributes is not yet working.

Will complete this for the v0.16.1 docs

@jorisvandenbossche merge when ready
