apply remaining changes from code review

docs/how-to/build-a-12-factor-app-rock.rst

@@ -18,8 +18,8 @@ the root of the project:
 - ``static``
 - ``templates``
 
-To change this, the following snippet needs to be added to
-the ``rockcraft.yaml``:
+To change this list, add the following snippet to the
+``rockcraft.yaml``:
 
 .. tabs::
 
@@ -134,32 +134,80 @@ Update and deploy the OCI image
 
       1. Make sure that any new files will be included in the new OCI image.
       2. Run ``rockcraft pack`` to create the new OCI image.
-      3. Run ``rockcraft.skopeo --insecure-policy copy --dest-tls-verify=false oci-archive:<path to rock file> docker://localhost:32000/<rock name>:<rock version>`` to upload the OCI image to the local Docker registry.
-      4. Run ``juju refresh <app name> --path=<relative path to .charm file> --resource flask-app-image=<localhost:32000/<rock name>:<rock version>>`` to deploy the new OCI image.
+      3. To upload the OCI image to the local Docker registry, run:
+
+         .. code-block:: bash
+
+            rockcraft.skopeo --insecure-policy copy --dest-tls-verify=false \
+            oci-archive:<path to rock file> \
+            docker://localhost:32000/<rock name>:<rock version>
+
+      4. To deploy the new OCI image, run:
+
+         .. code-block:: bash
+
+            juju refresh <app name> --path=<relative path to .charm file> \
+            --resource flask-app-image=<localhost:32000/<rock name>:<rock version>>
 
    .. group-tab:: Django
 
       After making a change to your app:
 
       1. Make sure that any new files will be included in the new OCI image.
       2. Run ``rockcraft pack`` to create the new OCI image.
-      3. Run ``rockcraft.skopeo --insecure-policy copy --dest-tls-verify=false oci-archive:<path to rock file> docker://localhost:32000/<rock name>:<rock version>`` to upload the OCI image to the registry.
-      4. Run ``juju refresh <app name> --path=<relative path to .charm file> --resource django-app-image=<localhost:32000/<rock name>:<rock version>>`` to deploy the new OCI image.
+      3. To upload the OCI image to the local Docker registry, run:
+
+         .. code-block:: bash
+
+            rockcraft.skopeo --insecure-policy copy --dest-tls-verify=false \
+            oci-archive:<path to rock file> \
+            docker://localhost:32000/<rock name>:<rock version>
+      
+      4. To deploy the new OCI image, run:
+
+         .. code-block:: bash
+
+            juju refresh <app name> --path=<relative path to .charm file> \
+            --resource django-app-image=<localhost:32000/<rock name>:<rock version>>
 
    .. group-tab:: FastAPI
 
       After making a change to your app:
 
       1. Make sure that any new files will be included in the new OCI image.
       2. Run ``rockcraft pack`` to create the new OCI image.
-      3. Run ``rockcraft.skopeo --insecure-policy copy --dest-tls-verify=false oci-archive:<path to rock file> docker://localhost:32000/<rock name>:<rock version>`` to upload the OCI image to the registry.
-      4. Run ``juju refresh <app name> --path=<relative path to .charm file> --resource app-image=<localhost:32000/<rock name>:<rock version>>`` to deploy the new OCI image.
+      3. To upload the OCI image to the local Docker registry, run:
+
+         .. code-block:: bash
+
+            rockcraft.skopeo --insecure-policy copy --dest-tls-verify=false \
+            oci-archive:<path to rock file> \
+            docker://localhost:32000/<rock name>:<rock version>
+
+      4. To deploy the new OCI image, run:
+
+         .. code-block:: bash
+
+            juju refresh <app name> --path=<relative path to .charm file> \
+            --resource app-image=<localhost:32000/<rock name>:<rock version>>
 
    .. group-tab:: Go
 
       After making a change to your app:
 
       1. Make sure that any new files will be included in the new OCI image.
       2. Run ``rockcraft pack`` to create the new OCI image.
-      3. Run ``rockcraft.skopeo --insecure-policy copy --dest-tls-verify=false oci-archive:<path to rock file> docker://localhost:32000/<rock name>:<rock version>`` to upload the OCI image to the registry.
-      4. Run ``juju refresh <app name> --path=<relative path to .charm file> --resource app-image=<localhost:32000/<rock name>:<rock version>>`` to deploy the new OCI image.
+      3. To upload the OCI image to the local Docker registry, run:
+
+         .. code-block:: bash
+
+            rockcraft.skopeo --insecure-policy copy --dest-tls-verify=false \
+            oci-archive:<path to rock file> \
+            docker://localhost:32000/<rock name>:<rock version>
+
+      4. To deploy the new OCI image, run:
+
+         .. code-block:: bash
+
+            juju refresh <app name> --path=<relative path to .charm file> \
+            --resource app-image=<localhost:32000/<rock name>:<rock version>>

docs/tutorial/django.rst

@@ -51,7 +51,7 @@ Change into the ``django_hello_world`` directory and run the Django application
 using ``python manage.py runserver`` to verify that it works.
 
 Test the Django application by using ``curl`` to send a request to the root
-endpoint. We may need a new terminal for this -- if we're using Multipass, run
+endpoint. We'll need a new terminal for this -- if we're using Multipass, run
 ``multipass shell rock-dev`` to get another terminal:
 
 .. literalinclude:: code/django/task.yaml

docs/tutorial/fastapi.rst

@@ -54,7 +54,7 @@ Run the FastAPI application using ``fastapi dev app.py --port 8000`` to verify
 that it works.
 
 Test the FastAPI application by using ``curl`` to send a request to the root
-endpoint. We may need a new terminal for this -- if we're using Multipass, run
+endpoint. We'll need a new terminal for this -- if we're using Multipass, run
 ``multipass shell rock-dev`` to get another terminal:
 
 .. literalinclude:: code/fastapi/task.yaml