fix(oci): apply suggestions from code review

Co-authored-by: Dimple Kuriakose <[email protected]>

oci/index.rst

@@ -1,7 +1,7 @@
 Ubuntu on OCI container registries
 ==================================
 
-**Ubuntu is one of the world's most popular container images.** A minimalistic Ubuntu image that offers the same security, versatility, and update cadence as other Ubuntu offerings. A developer favourite in container registries such as Docker Hub, with up to 30,000 pulls per week.
+**Ubuntu is one of the world's most popular container images,** a minimalistic Ubuntu image that offers the same security, versatility, and update cadence as other Ubuntu offerings. It is a developer favourite in container registries such as Docker Hub, with up to 30,000 pulls per week.
 
 **Available in all major OCI container registries,** such as Microsoft's ACR, Amazon's ECR, and of course, Docker Hub, as an official image from a verified publisher - Canonical. 
 
@@ -30,7 +30,7 @@ Ubuntu on OCI container registries
    .. grid-item-card:: :ref:`How-to guides <oci-how-to>`
 
       **Step-by-step guides** - learn how to use the Ubuntu container image to
-      achieve a goal, like :ref:`deploying a Pro container
+      achieve specific goals, like :ref:`deploying a Pro container
       image to a Pro Kubernetes cluster
       <how-to-deploy-pro-container-on-pro-cluster>`.
 
@@ -40,8 +40,8 @@ Ubuntu on OCI container registries
 
    .. grid-item-card:: :ref:`Reference <oci-reference>`
 
-      **Technical information** - understand the Ubuntu container images'
-      design and where you can get them from.
+      **Technical information** - understand the design of Ubuntu container images
+      and where you can get them from.
 
    .. grid-item-card:: :ref:`Explanation <oci-explanation>`
 

oci/oci-explanation/index.rst

@@ -4,7 +4,7 @@
 Explanation
 ***********
 
-This section of the documentation covers the definitions of the Ubuntu and
+Here you'll find the definitions of the Ubuntu and
 Ubuntu Pro container images.
 
 .. toctree::

oci/oci-explanation/ubuntu-oci-container.rst

@@ -11,9 +11,9 @@ provides OCI-compliant images that receive stable security updates and predictab
 software updates, ensuring consistency in both maintenance schedule and operational 
 interfaces for the underlying foundation your software builds on.
 
-Moreover, `Ubuntu-based containers <https://ubuntu.com/containers>`_ (like
+Moreover, all `Ubuntu-based containers <https://ubuntu.com/containers>`_ (like
 `chiselled container images <https://canonical-rockcraft.readthedocs-hosted.com/en/latest/explanation/chisel/>`_)
-all leverage the Ubuntu container image as their
+leverage the Ubuntu container image as their
 starting point, and so also benefit from its
 `support and security commitments <https://ubuntu.com/security/docker-images>`_.
 

oci/oci-how-to/index.rst

@@ -24,7 +24,7 @@ Learn how to build your own Ubuntu Pro container image from a regular Ubuntu con
 .. toctree::
    :maxdepth: 1
 
-   enable-pro-services
+   Enable Ubuntu Pro services in a Dockerfile <enable-pro-services>
 
 
 Deployments
@@ -47,7 +47,7 @@ You can create even smaller Ubuntu container images with Chisel.
 .. toctree::
    :maxdepth: 1
 
-   create-chiselled-ubuntu-image
+   Create a chiselled Ubuntu image <create-chiselled-ubuntu-image>
 
 
 Documentation

oci/oci-reference/index.rst

@@ -3,7 +3,7 @@
 Reference
 *********
 
-This section of the documentation contains an in-depth description the Ubuntu
+Here you'll find an in-depth description of the Ubuntu
 image's OCI configuration.
 
 .. toctree::

readme.rst

@@ -83,7 +83,7 @@ Each project has its own contribution guide:
 * `Azure <https://canonical-azure.readthedocs-hosted.com/en/latest/azure-how-to/contribute-to-these-docs/>`_
 * `Google <https://canonical-gcp.readthedocs-hosted.com/en/latest/google-how-to/contribute-to-these-docs/>`_
 * `IBM <https://canonical-ibm.readthedocs-hosted.com/en/latest/ibm-how-to/contribute-to-these-docs/>`_
-* `OCI Container registries <https://canonical-oci.readthedocs-hosted.com/en/latest/oci-how-to/contribute-to-these-docs/>`_
+* `OCI container registries <https://canonical-oci.readthedocs-hosted.com/en/latest/oci-how-to/contribute-to-these-docs/>`_
 * `Oracle <https://canonical-oracle.readthedocs-hosted.com/en/latest/oracle-how-to/contribute-to-these-docs/>`_