DOCSP-44988 automation page feedback (#74)

* DM automation feedback

* network security image fix

Author: kyuan-mongodb

source/automation.txt

@@ -17,17 +17,19 @@ Automation
 .. contents:: On this page
    :local:
    :backlinks: none
-   :depth: 2
+   :depth: 3
    :class: onecol
 
 |service-fullname| provides an easy way to host and manage your data in
-the cloud. It includes tools that automate the deployment, scaling, and
-maintenance of your {+service+} {+clusters+} to streamline operations,
-reduce manual interventions, and ensure consistent, policy-compliant
-deployments. These tools offer you the flexibility to work with
-|service| through direct scripting (such as scripts that call the
-{+atlas-admin-api+}), a Kubernetes-native workflow, or
-using Infrastructure as Code (IaC) tools like Terraform.    
+the cloud. It includes tools that enable programmatic management of the
+deployment, scaling, and maintenance of your {+service+} {+clusters+} to
+streamline operations, reduce manual interventions, and ensure
+consistent, policy-compliant deployments. These tools offer you the
+flexibility to work with {+service+} through direct scripting (such as
+scripts that use the GoSDK Client or call the {+atlas-admin-api+}
+directly), or Infrastructure as Code (IaC) tooling that uses declarative
+configuration, like our Kubernetes Operator, Terraform, Cloud Formation
+or AWS CDK.
 
 {+service+} Features and Recommendations for Automation
 -------------------------------------------------------
@@ -38,8 +40,7 @@ Features
 You can automate the management, provisioning, and configuration of
 |service| building blocks like database users and roles, |service|
 {+clusters+}, projects and organizations. Additionally, you can automate
-temporary access list entries that expire after a user-defined period, and
-setting up and managing of additional {+clusters+} resources, including
+setting up and managing additional {+clusters+} resources, including
 enabling auto-scaling compute and storage, creating and updating
 multi-cloud {+clusters+}, monitoring {+cluster+} performance and health,
 automating backups and restores, defining backup policies, and many more.
@@ -74,14 +75,8 @@ To learn more, see :ref:`Atlas Go SDK <atlas-admin-sdk>`.
 
 .. _arch-center-iac:
 
-Infrastructure as Code (IaC) Integrations 
-`````````````````````````````````````````
-
-The integrations with the following :abbr:`IaC (Infrastructure as Code)`
-tools automate the deployment of |service| resources.
-
 HashiCorp Terraform MongoDB Atlas Provider
-##########################################
+``````````````````````````````````````````
 
 Provisions |service| resources across cloud providers (|aws|, |azure|,
 |gcp|) in the workflow of your choice. It allows you to integrate
@@ -98,7 +93,7 @@ To learn more, see :ref:`getting-started-terraform` and the
 Cluster<arch-center-hierarchy>` examples to get started. 
 
 CloudFormation Resources
-########################
+````````````````````````
 
 Resources to manage |service| include:
 
@@ -115,8 +110,8 @@ To learn more, see `Deploy MongoDB Atlas with AWS CloudFormation <https://www.mo
 {+atlas-cli+} 
 `````````````
 
-Enables you to create, manage, and automate tasks related to |service|
-resources from a unified command line tool. 
+Enables you to manually or programmatically create, manage, and automate
+tasks related to |service| resources from a unified command line tool.
 
 To learn more, see the following resources:
 
@@ -144,18 +139,21 @@ Recommendations
 If you already have an existing tool integrated into your deployment
 workflow that you use today, we recommend that you use that tool for
 automation. For example, if your developers and operations team are
-used to building custom resource definitions for Kubernetes for
-deployment, use the |ak8so| and Kubernetes for automation in 
-{+service+}.
-
-If you don't already have an existing tool integrated into your development workflow, we recommend an :ref:`IaC tool <arch-center-iac>`
-because they provide more robust options for infrastructure provisioning and state management.
-If you instead call the {+atlas-admin-api+} directly or use the GoSDK, which wraps the {+atlas-admin-api+}, you might need to recreate your
-infrastructure provisioning each time to match your needs across
-environments.
+already deploying to Kubernetes, apply {+service+} configurations through
+the same tooling and pipelines and use the |ak8so| to automate updating
+{+service+}. 
+
+If you don't already have an existing tool integrated into your
+development workflow, we recommend an :ref:`IaC tool <arch-center-iac>` 
+because they provide more robust options for infrastructure provisioning
+and state management. If you instead call the {+atlas-admin-api+}
+directly or use the GoSDK, which wraps the {+atlas-admin-api+}, you
+might need to recreate your infrastructure provisioning each time to
+match your needs across environments.
 
 You can also use a combination of multiple tools. For example, use IaC
-tool for provisioning and state management, and leverage the {+atlas-admin-api+}, GoSDK, and {+atlas-cli+} for quick administrative
+tool for provisioning and state management, and leverage the
+{+atlas-admin-api+}, GoSDK, and {+atlas-cli+} for quick administrative
 tasks that are ephemeral in nature. The {+atlas-cli+} is great for
 local development as well as integration into a suite of tests as part
 of your CI/CD pipeline for application development because it improves

source/includes/images/private-link.png

@@ -126,7 +126,7 @@ peer to. {+service+} limits the number of MongoDB instances per |vpc|
 based on the |cidr| block. For example, a project with a |cidr| block of
 ``/24`` is limited to the equivalent of 273-node replica sets.
 
-.. image:: /includes/images/vpc-vnet-peering.png
+.. image:: /includes/images/vpc-vnet-peering.svg
    :alt: "An image representing how MongoDB Atlas VPC/VNet peering works."
    :width: 750px
    :align: center
@@ -147,7 +147,7 @@ private endpoints are available:
 - :gcp:`Private Service Connect </vpc/docs/private-service-connect>`, for
   connections from {+gcp+}
 
-.. image:: /includes/images/private-link.png
+.. image:: /includes/images/private-link.svg
    :alt: "An image representing how MongoDB Atlas private endpoints work."
    :width: 750px
    :align: center