doc(bigtable): create page for configuration options (#10197)

google/cloud/bigtable/doc/bigtable-options.dox

@@ -0,0 +1,9 @@
+/*!
+@defgroup bigtable-options Bigtable Client Library Configuration Options
+
+The Bigtable client library uses the same mechanism as all other C++ client
+libraries for configuration. As usual for the C++ client libraries, it adds a
+number of unique options only applicable for the Bigtable library.
+
+@see @ref options - for an overview of client library configuration.
+*/

google/cloud/bigtable/options.h

@@ -69,6 +69,8 @@ GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN
  *
  * @see https://cloud.google.com/bigtable/docs/replication-overview#app-profiles
  *     for how app profiles are used to achieve replication.
+ *
+ * @ingroup bigtable-options
  */
 struct AppProfileIdOption {
   using Type = std::string;
@@ -109,6 +111,8 @@ struct InstanceAdminEndpointOption {
  * Minimum time in ms to refresh connections.
  *
  * The server will not disconnect idle connections before this time.
+ *
+ * @ingroup bigtable-options
  */
 struct MinConnectionRefreshOption {
   using Type = std::chrono::milliseconds;
@@ -123,6 +127,8 @@ struct MinConnectionRefreshOption {
  *
  * @note If this value is less than the value of `MinConnectionRefreshOption`,
  * it will be set to the value of `MinConnectionRefreshOption`.
+ *
+ * @ingroup bigtable-options
  */
 struct MaxConnectionRefreshOption {
   using Type = std::chrono::milliseconds;
@@ -145,17 +151,29 @@ using DataLimitedErrorCountRetryPolicy =
     ::google::cloud::internal::LimitedErrorCountRetryPolicy<
         bigtable::internal::SafeGrpcRetry>;
 
-/// Option to configure the retry policy used by `Table`.
+/**
+ * Option to configure the retry policy used by `Table`.
+ *
+ * @ingroup bigtable-options
+ */
 struct DataRetryPolicyOption {
   using Type = std::shared_ptr<DataRetryPolicy>;
 };
 
-/// Option to configure the backoff policy used by `Table`.
+/**
+ * Option to configure the backoff policy used by `Table`.
+ *
+ * @ingroup bigtable-options
+ */
 struct DataBackoffPolicyOption {
   using Type = std::shared_ptr<BackoffPolicy>;
 };
 
-/// Option to configure the idempotency policy used by `Table`.
+/**
+ *  Option to configure the idempotency policy used by `Table`.
+ *
+ * @ingroup bigtable-options
+ */
 struct IdempotentMutationPolicyOption {
   using Type = std::shared_ptr<bigtable::IdempotentMutationPolicy>;
 };