DOCSP-41954: Create a connection string (#99)

* DOCSP-41954: Create a connection string

* edits

* spacing

Author: norareidy

.gitignore

@@ -3,5 +3,4 @@ build/*
 build
 *~
 *giza.log
-source/*
 backups/*

source/get-started.txt

@@ -20,4 +20,5 @@ Get Started with the PHP Library
 
 .. toctree::
 
-   /get-started/create-a-deployment/
+   /get-started/create-a-deployment/
+   /get-started/create-a-connection-string/

source/get-started/create-a-connection-string.txt

@@ -0,0 +1,68 @@
+.. _php-connection-string:
+
+==========================
+Create a Connection String
+==========================
+
+.. facet::
+   :name: genre
+   :values: tutorial
+
+.. meta::
+   :keywords: uri, atlas
+
+You can connect to your MongoDB deployment by providing a
+**connection URI**, also called a *connection string*, which
+instructs the driver on how to connect to a MongoDB deployment
+and how to behave while connected.
+
+The connection string includes the hostname or IP address and 
+port of your deployment, the authentication mechanism, user credentials 
+when applicable, and connection options.
+
+.. TODO:
+ To connect to an instance or deployment not hosted on Atlas, see
+ :ref:`php-connection-targets`.
+
+.. procedure::
+   :style: connected
+
+   .. step:: Find your MongoDB Atlas Connection String
+
+      To retrieve your connection string for the deployment that
+      you created in the :ref:`previous step <php-create-deployment>`,
+      log in to your Atlas account and navigate to the
+      :guilabel:`Database` section and click the :guilabel:`Connect` button
+      for your new deployment.
+
+      .. figure:: /includes/figures/atlas_connection_select_cluster.png
+         :alt: The connect button in the clusters section of the Atlas UI
+
+      Then, select your user from the :guilabel:`Select database user`
+      selection menu. Select "PHP" from the :guilabel:`Driver` selection
+      menu and the version that best matches the version you installed
+      from the :guilabel:`Version` selection menu.
+      
+      Select the :guilabel:`String` tab in the :guilabel:`Add connection string into your application code`
+      step to view only the connection string.
+
+   .. step:: Copy your Connection String
+
+      Click the button on the right of the connection string to copy it
+      to your clipboard, as shown in the following screenshot:
+
+      .. figure:: /includes/figures/atlas_connection_copy_string_php.png
+         :alt: The copy button next to the connection string in the Atlas UI
+
+   .. step:: Update the Placeholders
+
+      Paste this connection string into a file in your preferred text editor
+      and replace the ``<username>`` and ``<password>`` placeholders with
+      your database user's username and password.
+      
+      Save this file to a safe location for use in the next step.
+
+After completing these steps, you have a connection string that
+corresponds to your Atlas cluster.
+
+.. include:: /includes/get-started/troubleshoot.rst

source/get-started/create-a-deployment.txt

@@ -9,7 +9,7 @@ Create a MongoDB Deployment
    :values: tutorial
 
 .. meta::
-   :keywords: cloud, uri, atlas
+   :keywords: cloud, host, atlas
 
 You can create a free tier MongoDB deployment on MongoDB Atlas
 to store and manage your data. MongoDB Atlas hosts and manages