// Copyright 2009-present MongoDB, Inc.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

#if !defined(MONGOCXX_PRIVATE_DOXYGEN_PREPROCESSOR)
#error "This file is for documentation purposes only. It should not be included."
#endif // !defined(MONGOCXX_PRIVATE_DOXYGEN_PREPROCESSOR)

///
/// @file
/// For documentation purposes only.
///
/// @note This header is not includable!
///

///
/// @page topic-mongocxx The mongocxx Library
/// @brief Topics relating to the mongocxx library.
/// @li @subpage topic-mongocxx-examples
/// @li @subpage topic-mongocxx-about
///

///
/// @page topic-mongocxx-examples How-To Guides
/// @brief Examples of how to use the mongocxx library.
/// @li @subpage topic-mongocxx-examples-instance
/// @li @subpage topic-mongocxx-examples-logger
/// @li @subpage topic-mongocxx-examples-uri
/// @li @subpage topic-mongocxx-examples-clients
/// @li @subpage topic-mongocxx-examples-databases
/// @li @subpage topic-mongocxx-examples-collections
/// @li @subpage topic-mongocxx-examples-client-sessions
/// @li @subpage topic-mongocxx-examples-change-streams
/// @li @subpage topic-mongocxx-examples-operation-exceptions
///

///
/// @page topic-mongocxx-examples-instance Instance
/// @brief How to use a MongoDB C++ Driver instance.
/// @tableofcontents
/// @include{doc} api/mongocxx/examples/instance.md
///

///
/// @page topic-mongocxx-examples-logger Logger
/// @brief How to use a custom logger with a MongoDB C++ Driver instance.
/// @tableofcontents
/// @include{doc} api/mongocxx/examples/logger.md
///

///
/// @page topic-mongocxx-examples-uri URI
/// @brief How to create and use URIs.
/// @tableofcontents
/// @see
/// - [Connection Strings (MongoDB Manual)](https://www.mongodb.com/docs/manual/reference/connection-string/)
/// @include{doc} api/mongocxx/examples/uri.md
///

///
/// @page topic-mongocxx-examples-clients Clients
/// @brief How to use clients and client pools.
/// @tableofcontents
/// @include{doc} api/mongocxx/examples/clients.md
///

///
/// @page topic-mongocxx-examples-client-sessions Client Sessions
/// @brief How to create and use client sessions.
/// @tableofcontents
/// @include{doc} api/mongocxx/examples/client_sessions.md
///

///
/// @page topic-mongocxx-examples-databases Databases
/// @brief How to obtain and use databases.
/// @tableofcontents
/// @include{doc} api/mongocxx/examples/databases.md
///

///
/// @page topic-mongocxx-examples-collections Collections
/// @brief How to obtain and use collections.
/// @tableofcontents
/// @include{doc} api/mongocxx/examples/collections.md
///

///
/// @page topic-mongocxx-examples-change-streams Change Streams
/// @brief How to obtain and use change streams.
/// @tableofcontents
/// @include{doc} api/mongocxx/examples/change_streams.md
///

///
/// @page topic-mongocxx-examples-operation-exceptions Operation Exceptions
/// @brief How to handle exceptions thrown by database and collection operations.
/// @tableofcontents
/// @include{doc} api/mongocxx/examples/operation_exceptions.md
///

///
/// @page topic-mongocxx-about Explanation
/// @brief Design decisions, history, and other technical details about the mongocxx library.
///
