Improve Tables doc comments based on what is available in the OpenAPI spec

[ahsonkhan]

Here's the rest API spec for it, which has some good descriptions for doc comments, that we can use:
https://github.com/Azure/azure-rest-api-specs/blob/main/specification/cosmos-db/data-plane/Microsoft.Tables/preview/2019-02-02/table.json

For example, we have this description for the response of GetEntity:
https://github.com/Azure/azure-rest-api-specs/blob/1aebb2dbe4fe12a555f8bf67ae89435c036ef387/specification/cosmos-db/data-plane/Microsoft.Tables/preview/2019-02-02/table.json#L411-L484

https://github.com/Azure/azure-sdk-for-go/blob/b7816620792994eafbc880bed20ef334e4ac73c3/sdk/data/aztables/client.go#L210-L213
https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/data/aztables#GetEntityResponse

The C++ Tables SDK has the following doc comments for it:

azure-sdk-for-cpp/sdk/tables/azure-data-tables/inc/azure/data/tables/tables_clients.hpp

Lines 304 to 315 in 8973c6c

	/**
	* @brief Get one table entity.
	*
	* @param partitionKey The partition key of the entity.
	* @param rowKey The row key of the entity.
	* @param context for canceling long running operations.
	* @return Table entity.
	*/
	Response<Models::TableEntity> GetEntity(
	const std::string& partitionKey,
	const std::string& rowKey,
	Core::Context const& context = {});