Improving the documentation of teh Table

I'm pushing this so we can all see what's missing and start dividing the work.

Please make a comment to this pull request when you start working on a method.