DOCSP-21848 ref tags (#98)

* swapping doc tags for ref tags

Author: jordan-smith721

source/compatibility.txt

@@ -1,3 +1,5 @@
+.. _golang-compatibility:
+
 Compatibility
 -------------
 

source/faq.txt

@@ -1,3 +1,5 @@
+.. _golang-faq:
+
 ===
 FAQ
 ===

source/fundamentals/auth.txt

@@ -1,3 +1,5 @@
+.. _golang-authentication-mechanisms:
+
 =========================
 Authentication Mechanisms
 =========================
@@ -19,18 +21,18 @@ authentication mechanisms to confirm an identity and establish trust to
 ensure security in the driver and server before connecting.
 
 If you want to establish a connection to your MongoDB cluster without an
-authentication mechanism, see our :doc:`Connection Guide </fundamentals/connection>`.
+authentication mechanism, see :ref:`golang-connection-guide`.
 
 Supported Mechanisms
 --------------------
 
 The Go driver supports the following authentication mechanisms:
 
-* :ref:`SCRAM-SHA-256 <go_sha_256>`
-* :ref:`SCRAM-SHA-1 <go_sha_1>`
-* :ref:`MONGODB-CR <go_mongodb_cr>`
-* :ref:`MongoDB-AWS <go_mongodb_aws>`
-* :ref:`X.509 <go_x509>`
+* :ref:`SCRAM-SHA-256 <golang_sha_256>`
+* :ref:`SCRAM-SHA-1 <golang-sha-1>`
+* :ref:`MONGODB-CR <golang-mongodb-cr>`
+* :ref:`MongoDB-AWS <golang-mongodb-aws>`
+* :ref:`X.509 <golang-x509>`
 
 The Go Driver establishes a connection with an authentication mechanism
 through a `Client <{+api+}/mongo#Client>`__
@@ -58,7 +60,7 @@ Each authentication mechanism contains the following placeholders:
   authentication data. If you omit this option, the driver uses the
   default value ``admin``.
 
-.. _default-auth-mechanism:
+.. _golang-default-auth-mechanism:
 
 Default
 ~~~~~~~
@@ -102,7 +104,7 @@ For more information on the challenge-response (CR) and salted
 challenge-response authentication mechanisms (SCRAM) that MongoDB supports,
 see the :manual:`SCRAM </core/security-scram/>` section of the server manual.
 
-.. _go_sha_256:
+.. _golang_sha_256:
 
 ``SCRAM-SHA-256``
 ~~~~~~~~~~~~~~~~~
@@ -133,8 +135,8 @@ To specify the ``SCRAM-SHA-256`` authentication mechanism, assign the
 
    client, err := mongo.Connect(context.TODO(), clientOpts)
 
-.. _scram-sha-1-auth-mechanism:
-.. _go_sha_1:
+.. _golang-scram-sha-1-auth-mechanism:
+.. _golang-sha-1:
 
 ``SCRAM-SHA-1``
 ~~~~~~~~~~~~~~~
@@ -165,7 +167,7 @@ To specify the ``SCRAM-SHA-1`` authentication mechanism, assign the
 
    client, err := mongo.Connect(context.TODO(), clientOpts)
 
-.. _go_mongodb_cr:
+.. _golang-mongodb-cr:
 
 ``MONGODB-CR``
 ~~~~~~~~~~~~~~
@@ -178,7 +180,7 @@ username and password to authenticate your user.
    This authentication mechanism was deprecated starting in MongoDB 3.6
    and is no longer supported as of MongoDB 4.0.
 
-.. _go_mongodb_aws:
+.. _golang-mongodb-aws:
 
 ``MONGODB-AWS``
 ~~~~~~~~~~~~~~~
@@ -239,7 +241,7 @@ option the value of your ``sessionToken``:
    assumeRoleClient, err := mongo.Connect(context.TODO(),
       options.Client().SetAuth(assumeRoleCredential))
 
-.. _go_x509:
+.. _golang-x509:
 
 ``X.509``
 ~~~~~~~~~
@@ -277,5 +279,5 @@ following:
 
 ..
   For more information on configuring your application to use
-  certificates as well as TLS/SSL options, see our
-  :doc:`TLS/SSL guide </fundamentals/connection/tls>`.
+  certificates as well as TLS/SSL options, see
+  :ref:`golang-tls-ssl-guide`.

source/fundamentals/bson.txt

@@ -1,4 +1,4 @@
-.. _bson-golang:
+.. _golang-bson:
 
 ==============
 Work with BSON
@@ -23,13 +23,13 @@ You should read this guide if you want to learn more about how the Go Driver
 represents BSON data or need to adjust default marshalling
 and unmarshalling behaviors.
 
-.. _bson-types:
+.. _golang-bson-types:
 
 Data Types
 ----------
 
 MongoDB stores documents in a binary representation called :manual:`BSON
-</reference/bson-types/>` that allows for easy and flexible data processing.
+</reference/golang-bson-types/>` that allows for easy and flexible data processing.
 
 The Go Driver provides four main types for working with BSON data:
 
@@ -210,7 +210,7 @@ Driver will marshal structs using the following rules:
       - Includes an empty ``lastname`` field
       - Stores the ``Address`` field as a nested value
 
-.. _bson-unmarshalling:
+.. _golang-bson-unmarshalling:
 
 Unmarshalling
 -------------

source/fundamentals/connection.txt

@@ -1,3 +1,5 @@
+.. _golang-connection-guide:
+
 ================
 Connection Guide
 ================
@@ -10,8 +12,6 @@ Connection Guide
    :depth: 2
    :class: singlecol
 
-.. _golang_connection_guide:
-
 This guide shows you how to connect to a MongoDB instance or replica set
 deployment using the Go Driver.
 
@@ -37,9 +37,7 @@ servers in rotation without reconfiguring clients.
 
 .. note::
 
-   If your deployment is on MongoDB Atlas, see the
-   :ref:`Quick Start guide <connect-to-your-cluster>` to learn how to
-   retrieve your connection string.
+   To learn how to retrieve your connection string in Atlas, see the :ref:`Quick Start guide <golang-connect-to-your-cluster>`.
 
 The next part of the connection string contains your username and, if
 you are using password-based authentication, your password. Replace the value of
@@ -55,7 +53,7 @@ your MongoDB instance.
 The last part of the connection string specifies connection and authentication
 options. In the example, we set two connection options:
 ``maxPoolSize=20`` and ``w=majority``. For more information on connection
-options, read the :ref:`connection-options` section of this guide.
+options, read the :ref:`golang-connection-options` section of this guide.
 
 The following code shows how you can use the sample connection URI in a
 client to connect to MongoDB.
@@ -126,7 +124,7 @@ connections:
 - Require you to :manual:`specify a secondary read preference </core/read-preference/#mongodb-readmode-secondary>`
   when the specified host isn't the **primary**.
 
-.. _connection-options:
+.. _golang-connection-options:
 
 ------------------
 Connection Options

source/fundamentals/connection/tls.txt

@@ -1,3 +1,5 @@
+.. _golang-tls-ssl-guide:
+
 ==============================
 Enable TLS/SSL on a Connection
 ==============================

source/fundamentals/context.txt

@@ -1,3 +1,5 @@
+.. _golang-context:
+
 =======
 Context
 =======
@@ -56,7 +58,7 @@ timeout error if the Context expired or the selection process took
 longer than the ``serverSelectionTimeoutMS`` setting.
 
 For more information on how the driver selects a server, see the
-:ref:`<replica-set-read-preference-behavior>`.
+:ref:`replica-set-read-preference-behavior`.
 
 Connection Checkout
 ~~~~~~~~~~~~~~~~~~~

source/fundamentals/crud.txt

@@ -1,3 +1,5 @@
+.. _golang-crud:
+
 ===============
 CRUD Operations
 ===============
@@ -14,11 +16,10 @@ CRUD Operations
 CRUD (Create, Read, Update, Delete) operations enable you to work with
 data stored in MongoDB.
 
-- :doc:`Read Operations </fundamentals/crud/read-operations>` find and return
+- :ref:`golang-crud-read-operations` find and return
   documents stored in your database.
-- :doc:`Write Operations </fundamentals/crud/write-operations>` insert, modify,
+- :ref:`golang-crud-write-operations` insert, modify,
   or delete documents in your database.
 
 Some operations combine aspects of read and write operations. To learn
-more about these hybrid methods, see our guide on :doc:`compound
-operations </fundamentals/crud/compound-operations>`.
+more about these hybrid methods, see :ref:`golang-compound-operations`.

source/fundamentals/crud/compound-operations.txt

@@ -1,4 +1,4 @@
-.. _compound-operations-golang:
+.. _golang-compound-operations:
 
 ===================
 Compound Operations
@@ -25,9 +25,9 @@ document you are modifying for the duration of your compound operation.
 
 MongoDB supports the following compound operations:
 
-- :ref:`Find and delete one document <go-find-and-delete>`
-- :ref:`Find and update one document <go-find-and-update>`
-- :ref:`Find and replace one document <go-find-and-replace>`
+- :ref:`Find and delete one document <golang-find-and-delete>`
+- :ref:`Find and update one document <golang-find-and-update>`
+- :ref:`Find and replace one document <golang-find-and-replace>`
 
 .. tip::
 
@@ -48,7 +48,7 @@ collection of the ``tea`` database:
 
 .. include:: /includes/fundamentals/tea-sample-data-ending.rst
 
-.. _go-find-and-delete:
+.. _golang-find-and-delete:
 
 Find and Delete
 ---------------
@@ -121,7 +121,7 @@ After running this example, the output resembles the following:
 
    [{_id ObjectID("...")} {type Assam} {rating 5}]
 
-.. _go-find-and-update:
+.. _golang-find-and-update:
 
 Find and Update
 ---------------
@@ -215,7 +215,7 @@ After running this example, the output resembles the following:
 
    [{_id ObjectID("...")} {type Oolong} {rating 9}]
 
-.. _go-find-and-replace:
+.. _golang-find-and-replace:
 
 Find and Replace
 ----------------
@@ -310,11 +310,11 @@ Additional Information
 For more information on performing the operations mentioned, see the
 following guides:
 
-- :ref:`query_document_golang`
-- :doc:`Retrieve Data </fundamentals/crud/read-operations/retrieve>`
-- :doc:`Delete a Document </fundamentals/crud/write-operations/delete>`
-- :doc:`Update or Replace a Document </fundamentals/crud/write-operations/change-a-document>`
-- :ref:`Access Data in a SingleResult <bson-unmarshalling>`
+- :ref:`golang-query-document`
+- :ref:`golang-retrieve`
+- :ref:`golang-delete-guide`
+- :ref:`golang-change-document`
+- :ref:`Access Data in a SingleResult <golang-bson-unmarshalling>`
 
 API Documentation
 ~~~~~~~~~~~~~~~~~

source/fundamentals/crud/read-operations.txt

@@ -1,19 +1,21 @@
+.. _golang-crud-read-operations:
+
 ===============
 Read Operations
 ===============
 
 .. default-domain:: mongodb
 
-- :doc:`/fundamentals/crud/read-operations/query-document`
-- :doc:`/fundamentals/crud/read-operations/count`
-- :doc:`/fundamentals/crud/read-operations/retrieve`
-- :doc:`/fundamentals/crud/read-operations/cursor`
-- :doc:`/fundamentals/crud/read-operations/distinct`
-- :doc:`/fundamentals/crud/read-operations/sort`
-- :doc:`/fundamentals/crud/read-operations/skip`
-- :doc:`/fundamentals/crud/read-operations/limit`
-- :doc:`/fundamentals/crud/read-operations/project`
-- :doc:`/fundamentals/crud/read-operations/text`
+- :ref:`golang-query-document`
+- :ref:`golang-count-documents`
+- :ref:`golang-retrieve`
+- :ref:`golang-cursor`
+- :ref:`golang-retrieve-distinct`
+- :ref:`golang-sort-results`
+- :ref:`golang-skip`
+- :ref:`golang-limit`
+- :ref:`golang-project`
+- :ref:`golang-search-text`
 
 ..
   - :doc:`/fundamentals/crud/read-operations/geo`