Improve API documentation of table components

[jattasNI]

Pull Request

🤨 Rationale

Ongoing efforts towards #824. This PR covers the table and its columns.

👩‍💻 Implementation

Mostly following established patterns. Some interesting notes:

1. For the Table Column Configuration doc, we had divided the documentation into separate targeted stories. I decided these were useful but we also should have a single table describing the whole API of a column. I created the latter under the API section and moved the targeted stories to an Examples section. Let me know if it feels right!
2. The above resulted in a renamed story which appears as a Chromatic diff.

🧪 Testing

Interacting with the built Storybook.

✅ Checklist

• I have updated the project documentation to reflect my changes or determined no changes are needed.

[jattasNI]

@m-akinc Here's another round of API docs for you to buddy. Thanks!

[jattasNI]

Bypassing reviewer policy due to OOO.