DOCSP-40961 -- Add more CRD metadata for better client user experience (#117)

* DOCSP-40961 -- add short names; add kubectl command updates

* Update source/custom-resources.txt

Co-authored-by: Evelyn Rabil <[email protected]>

---------

Co-authored-by: Evelyn Rabil <[email protected]>

Author: jvincent-mongodb

source/custom-resources.txt

@@ -16,50 +16,79 @@ Custom Resources
 
 .. list-table::
    :header-rows: 1
-   :widths: 30 70
+   :widths: 30 60 10
 
    * - Resource
      - Description
+     - Short Name
 
    * - :ref:`atlasbackuppolicy-custom-resource`
      - Backup policy to back up your {+cluster+}
        |service|.
+     - abp
 
    * - :ref:`atlasbackupschedule-custom-resource`
      - Backup schedule to back up your {+cluster+}
        |service|.
+     - abs
 
    * - :ref:`atlasdeployment-custom-resource`
      - {+Cluster+} inside some project in |service|.
+     - ad
 
    * - :ref:`atlasdatabaseuser-custom-resource`
      - Database user inside some project in 
        |service|.
+     - adu
 
    * - :ref:`atlasproject-custom-resource`
      - Project in |service|. 
+     - ap
 
    * - :ref:`atlasteam-custom-resource`
      - Project team in |service|.
+     - at
 
    * - :ref:`atlasdatafederation-custom-resource`
      - {+fdi+} and its private endpoints in 
        |service|.
+     - adf
 
    * - :ref:`atlassearchindexconfig-custom-resource`
      - Index for some collection in your |service| {+cluster+}.
+     - asic
 
    * - :ref:`atlasstreamconnection-custom-resource`
      - {+atlas-sp+} connection.
+     - asc
 
    * - :ref:`atlasstreaminstance-custom-resource`
      - {+atlas-sp+} instance.
+     - asi
 
    * - :ref:`atlasfederatedauth-custom-resource`
      - Federated authentication in |service|.
+     - afa
 
 .. include:: /includes/fact-ak8so-crds.rst
 
+Managing |ak8so| with ``kubectl``
+-----------------------------------
+
+To list all |ak8so| resources in your cluster with ``kubectl``, you can run:
+
+.. code-block:: sh
+
+   kubectl get atlas
+
+For your convenience, to list or describe specific types of |ak8so| CRDs, 
+you can use the short names listed in the above table. For example, to list all
+``atlasdatabaseusers`` in the ``mongodb`` namespace, you can run:
+
+.. code-block:: sh
+
+   kubectl get adu -n mongodb
+
 |ak8so| Workflow
 ----------------