Link REST request/response class Javadocs to OpenAPI Spec definitions

[kbendick]

As part of the REST catalog, we have to implement several request / response classes.

It would be nice to link the classes themselves to the OpenAPI document in the class javadoc (or some other way if that's not possible), similar to {@link ...} annotations in javadoc comments.

Opening this issue to follow up on this comment thread: https://github.com/apache/iceberg/pull/4037#discussion_r800917182

[github-actions[bot]]

This issue has been automatically marked as stale because it has been open for 180 days with no activity. It will be closed in next 14 days if no further activity occurs. To permanently prevent this issue from being considered stale, add the label 'not-stale', but commenting on the issue is preferred when possible.

[github-actions[bot]]

This issue has been closed because it has not received any activity in the last 14 days since being marked as 'stale'