Add table classes to the documentation
Just note that docstrings injected from PyArrow do not follow the same convention for formatting types in `Args` or `Returns` as we do... Not a big problem, anyway! 😄 
Following #2025 , I added the table classes to the documentation

cc @albertvillanova 