index.txt

=================
{+driver-long+}
=================

.. default-domain:: mongodb

.. facet::
   :name: genre
   :values: reference

.. toctree::
   :titlesonly:
   :maxdepth: 1

   /quick-start
   /quick-reference
   /whats-new
   /usage-examples
   /fundamentals
   API Documentation <{+api+}/mongo>
   /faq
   /connection-troubleshooting
   /issues-and-help
   /compatibility
   View the Source <https://github.com/mongodb/mongo-go-driver>

..
  /upgrade

Introduction
------------

Welcome to the documentation site for the official {+driver-long+}.
You can add the driver to your application to work with MongoDB in Go.
Download it using `go get <https://pkg.go.dev/cmd/go/internal/get>`__
or set up a runnable project by following our Quick Start guide.

Compatibility
-------------

You can use the {+driver-short+} to connect to deployments hosted in the
following environments:

.. include:: /includes/fact-environments.rst

Quick Start
-----------

Learn how to establish a connection to MongoDB Atlas and begin
working with data in the :ref:`golang-quickstart` section.

Quick Reference
---------------

See driver syntax examples for common MongoDB commands in the
:ref:`Quick Reference <golang-quick-reference>` section.

What's New
----------

For a list of new features and changes in each version, see the
:ref:`golang-whats-new` section.

Usage Examples
--------------

For fully runnable code snippets and explanations for common
methods, see :ref:`golang-usage-examples`.

Fundamentals
------------

.. include:: /includes/fundamentals-sections.rst

API
---

For detailed information about types and methods in the MongoDB
Go driver, see the `{+driver-long+} API documentation
<{+api+}/mongo>`__.

FAQ
---

For answers to commonly asked questions about the MongoDB
Go Driver, see :ref:`golang-faq`
section.

Connection Troubleshooting
--------------------------

For solutions to some issues you might see when connecting to a MongoDB
deployment while using the {+driver-long+}, see
:ref:`golang-connection-troubleshooting`.

Issues & Help
-------------

Learn how to report bugs, contribute to the driver, and find
additional resources for asking questions in the :ref:`golang-issues-and-help` section.

Compatibility
-------------

For the compatibility charts that show the recommended Go Driver version
for each MongoDB Server version, see :ref:`golang-compatibility`.

Learn
------

Visit the Developer Hub and MongoDB University to learn more about the
{+driver-long+}.

Developer Hub
~~~~~~~~~~~~~

The Developer Hub provides tutorials and social engagement for
developers.

To learn how to use MongoDB features with the Go driver, see the `How
To's and Articles page <https://www.mongodb.com/developer/learn/?content=Articles&text=go#main>`__.

To ask questions and engage in discussions with fellow developers using
the Go Driver, see the `forums page <https://www.mongodb.com/community/forums/tag/golang>`__.