PRR fixes

Author: Chris Cho

.gitignore

@@ -9,3 +9,4 @@ composer.phar
 phpunit.xml
 phpstan.neon
 /.cache/
+docs/.vscode

docs/includes/quick-start/troubleshoot.rst

@@ -1,6 +1,6 @@
 .. note::
 
-   If you run into issues on this step, ask for help in the
+   If you run into issues, ask for help in the
    :community-forum:`MongoDB Community Forums <>` or submit feedback by using
    the :guilabel:`Share Feedback` tab on the right or bottom right side of the
    page.

docs/quick-start.txt

@@ -20,8 +20,8 @@ Quick Start
 Overview
 --------
 
-This guide shows you how to add {+odm-long+} to a new Laravel web application,
-connect to a MongoDB cluster hosted on MongoDB Atlas, and how to perform
+This guide shows you how to add the {+odm-long+} to a new Laravel web
+application, connect to a MongoDB cluster hosted on MongoDB Atlas, and perform
 read and write operations on the data.
 
 .. tip::
@@ -32,7 +32,7 @@ read and write operations on the data.
    MongoDB Developer Center tutorial.
 
    You can learn how to set up a local Laravel development environment
-   and perform CRUD operations by taking the
+   and perform CRUD operations by viewing the
    :mdbu-course:`Getting Started with Laravel and MongoDB </getting-started-with-laravel-and-mongodb>`
    MongoDB University Learning Byte.
 

docs/quick-start/configure-mongodb.txt

@@ -41,16 +41,16 @@ Configure Your MongoDB Connection
 
          // ...
 
-      .. step:: Add the Laravel MongoDB Provider
+   .. step:: Add the Laravel MongoDB Provider
 
-         Open the ``app.php`` in the ``config`` directory and
-         add the following entry into the ``providers`` array:
+      Open the ``app.php`` file in the ``config`` directory and
+      add the following entry into the ``providers`` array:
 
-         .. code-block::
+      .. code-block::
 
-            MongoDB\Laravel\MongoDBServiceProvider::class,
+         MongoDB\Laravel\MongoDBServiceProvider::class,
 
 .. include:: /includes/quick-start/troubleshoot.rst
 
 .. button:: Next: View Sample MongoDB Data
-   :uri: /quick-start/view-data/
+   :uri: /quick-start/view-data/

docs/quick-start/create-a-connection-string.txt

@@ -13,7 +13,7 @@ The connection string includes the hostname or IP address and
 port of your deployment, the authentication mechanism, user credentials
 when applicable, and connection options.
 
-To connect to an instance or deployment not hosted on Atlas, see the
+To connect to an instance or deployment not hosted on Atlas, see
 :manual:`Connection Strings </reference/connection-string/>` in the Server
 manual.
 
@@ -24,7 +24,7 @@ manual.
 
       To retrieve your connection string for the deployment that
       you created in the :ref:`previous step <laravel-quick-start-create-deployment>`,
-      log in to your Atlas account and navigate to the
+      log in to your Atlas account. Then, navigate to the
       :guilabel:`Database` section and click the :guilabel:`Connect` button
       for your new deployment.
 
@@ -38,7 +38,7 @@ manual.
 
       Select the :guilabel:`Password (SCRAM)` authentication mechanism.
 
-      Deselect the :guilabel:`Include full driver code example` to view
+      Deselect the :guilabel:`Include full driver code example` option to view
       the connection string.
 
    .. step:: Copy your Connection String

docs/quick-start/download-and-install.txt

@@ -33,19 +33,18 @@ to a Laravel web application.
 
    .. step:: Install the {+php-extension+}
 
-      The {+odm-short+} requires the {+php-extension+} to manage MongoDB
+      {+odm-short+} requires the {+php-extension+} to manage MongoDB
       connections and commands.
       Follow the `Installing the MongoDB PHP Driver with PECL <https://www.php.net/manual/en/mongodb.installation.pecl.php>`__
-      guide to install {+php-extension+}.
+      guide to install the {+php-extension+}.
 
    .. step:: Install Laravel
 
       Ensure that the version of Laravel you install is compatible with the
-      version of {+odm-short+}. 
+      version of {+odm-short+}. To learn which versions are compatible,
+      see the :ref:`laravel-compatibility` page.
 
-
-      Then run the following command to install
-      Laravel.
+      Run the following command to install Laravel:
 
       .. code-block:: bash
 
@@ -61,29 +60,37 @@ to a Laravel web application.
 
    .. step:: Create a Laravel Application
 
-         Run the following command to generate a new Laravel web application
-         called ``{+quickstart-app-name+}``:
+      Run the following command to generate a new Laravel web application
+      called ``{+quickstart-app-name+}``:
+
+      .. code-block:: bash
+
+         laravel new {+quickstart-app-name+}
+
+      When the installation completes, you should see the
+      following output:
+
+      .. code-block:: none
+         :copyable: false
 
-         .. code-block:: bash
+         INFO  Application ready in [{+quickstart-app-name+}]. You can start your local development using:
 
-            laravel new {+quickstart-app-name+}
+         ➜ cd {+quickstart-app-name+}
+         ➜ php artisan serve
 
-         When the installation completes, you should see the
-         following output:
+         New to Laravel? Check out our bootcamp and documentation. Build something amazing!
 
-         .. code-block:: none
-            :copyable: false
+   .. step:: Add a Laravel Application Encryption Key
 
-            INFO  Application ready in [{+quickstart-app-name+}]. You can start your local development using:
+      Run the following command to add the Laravel application encryption
+      key which is required to encrypt cookies:
 
-            ➜ cd {+quickstart-app-name+}
-            ➜ php artisan serve
+      .. code-block:: bash
 
-            New to Laravel? Check out our bootcamp and documentation. Build something amazing!
+         php artisan key:generate
 
    .. step:: Add {+odm-short+} to the Dependencies
 
-
       Navigate to the application directory you created in the previous step:
 
       .. code-block:: bash

docs/quick-start/next-steps.txt

@@ -11,17 +11,12 @@ Next Steps
 .. meta::
    :keywords: learn more
 
-Congratulations on completing the quick start tutorial!
+Congratulations on completing the Quick Start tutorial!
 
 After you complete these steps, you have a Laravel web application that
 uses the {+odm-long+} to connect to your MongoDB deployment, run a query on
 the sample data, and render a retrieved result.
 
-In this tutorial, you created a Laravel web application that uses the
-{+odm-long+} to connect to your MongoDB deployment, render the result
-of a query, and write data to a MongoDB deployment hosted on
-MongoDB Atlas.
-
 You can download the web application project by cloning the
 `laravel-quickstart <https://github.com/mongodb-university/laravel-quickstart>`__
 GitHub repository.

docs/quick-start/view-data.txt

@@ -14,12 +14,11 @@ View Sample MongoDB Data
 .. procedure::
    :style: connected
 
-   .. step:: Create a Sample Model and Controller
+   .. step:: Create a Model and Controller
 
       Create a model called ``Movie`` to represent data from the sample
-      ``movies`` collection in your MongoDB database. You can create the
-      model with a corresponding resource controller by running the
-      following command:
+      ``movies`` collection in your MongoDB database and the corresponding
+      resource controller by running the following command:
 
       .. code-block:: bash
 
@@ -110,9 +109,10 @@ View Sample MongoDB Data
          INFO  View [resources/views/browse_movie.blade.php] created successfully.
 
       Open the ``browse_movie.blade.php`` view file in the ``resources/views``
-      directory. Replace the contents with the following code:
+      directory. Replace the contents with the following code and save the
+      changes:
 
-      .. code-block:: bash
+      .. code-block:: html
 
          <!DOCTYPE html>
          <html>

docs/quick-start/write-data.txt

@@ -14,11 +14,11 @@ Post an API Request to Write Data
 .. procedure::
    :style: connected
 
-   .. step:: Create the Function to Store Data
+   .. step:: Create the Function to Insert Data
 
-      Add logic to save the data from a request in the ``MovieController.php``
-      file in the ``app/Http/Controllers/`` directory. Replace the existing
-      placeholder ``store()`` method with the following code:
+      Update the ``store()`` method ``MovieController.php``, located in
+      the ``app/Http/Controllers`` directory to insert request data
+      into the database as shown in the following code:
 
       .. code-block:: php
 
@@ -32,8 +32,8 @@ Post an API Request to Write Data
 
    .. step:: Add a Route for the Controller Function
 
-      Add the API route to map to the ``store()`` method in the
-      ``routes/api.php`` file.
+      Add the following API route to map to the ``store()`` method and the
+      corresponding import in the ``routes/api.php`` file:
 
       .. code-block:: php
 
@@ -46,11 +46,10 @@ Post an API Request to Write Data
          ]);
 
 
-   .. step:: Update the Movie Model
+   .. step:: Update the Model Fields
 
-      Add the movie detail fields to the ``$fillable`` array
-      of the ``Movie`` model. After adding them, the ``Movie``
-      class at ``app/Models/Movie.php`` should contain the
+      Update the ``Movie`` model in the ``app/Models`` directory to
+      specify fields that the ``fill()`` method populates as shown in the
       following code:
 
       .. code-block:: php
@@ -87,8 +86,8 @@ Post an API Request to Write Data
 
    .. step:: View the Data
 
-      Open ``http://127.0.0.1:8000/browse_movies`` in your web browser to view 
-      the movie information that you submitted. It should appear at the top of 
+      Open ``http://127.0.0.1:8000/browse_movies`` in your web browser to view
+      the movie information that you submitted. It should appear at the top of
       the results.
 
 .. include:: /includes/quick-start/troubleshoot.rst