(DOCSP-47879) SEO improvements (#126)

* (DOCSP-47879) SEO improvements

* Changes Features and Recommendations to Guidance for pages that have both

* Lengthens pillar page titles

Author: sarahsimpers

config/redirects

@@ -9,3 +9,8 @@ symlink: current -> main
 raw: ${bucket_prefix}/ -> ${base}/current/
 raw: ${bucket_prefix}/index.html -> ${base}/current/
 
+########
+
+# All Arch Center versions
+
+[*]: ${bucket_prefix}/${version}/changelog -> ${base}/${version}/release-notes/

snooty.toml

@@ -170,7 +170,7 @@ play-store = "https://play.google.com/store/apps/"
 vault = "`HashiCorp Vault <https://www.vaultproject.io/>`__"
 vpc = ":abbr:`VPC (Virtual Private Cloud)`"
 vnet = "VNet"
-waf = "Atlas Well-Architected Framework"
+waf = "`Well-Architected Framework <https://www.mongodb.com/resources/products/capabilities/well-architected-framework>`__"
 wif = "Workforce Identity Federation"
 workload = "Workload Identity Federation"
 

source/auditing-logging.txt

@@ -1,8 +1,8 @@
 .. _arch-center-auditing-logging:
 
-====================
-Auditing and Logging
-====================
+=============================================
+Guidance for {+service+} Auditing and Logging
+=============================================
 
 .. default-domain:: mongodb
 
@@ -14,16 +14,13 @@ Auditing and Logging
 
 To monitor and log |service| platform activities, use auditing and logs.
 
-{+service+} Features and Recommendations for Auditing and Logging
------------------------------------------------------------------
-
-Features
-~~~~~~~~
+Features for {+service+} Auditing and Logging
+---------------------------------------------
 
 .. _auditing:
 
 Auditing
-````````
+~~~~~~~~
 
 Available on ``M10+`` {+clusters+}, database auditing lets you track system 
 activity for deployments with
@@ -58,7 +55,7 @@ multiple users. As an |service| administrator, you can:
 .. _accessing-audit-logs:
 
 Accessing Audit Logs
-````````````````````
+~~~~~~~~~~~~~~~~~~~~
 
 .. include:: /includes/cloud-docs/logs.rst
 
@@ -83,8 +80,10 @@ To perform a full audit, you can use a combination of audit logs,
 :manual:`MongoDB log messages </reference/log-messages/>`, and
 :ref:`the project and organization activity feed <view-activity-feed>`.
 
-Recommendations for Auditing
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. _arch-center-auditing-logging-recs:
+
+Recommendations for {+service+} Auditing and Logging
+----------------------------------------------------
 
 We recommend that you :atlas:`set up database auditing </database-auditing>`
 when you provision your {+clusters+}. 
@@ -133,8 +132,8 @@ information at a minimum:
 - Timestamp
 - Error code (if applicable)
 
-Recommendations for Programmatic Access to Audit Logs
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Programmatic Access to Audit Logs
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 To integrate with tools beyond the built-in integrations, we recommend
 that you retrieve logs with the following programmatic tools and feed
@@ -148,8 +147,8 @@ the JSON-formatted output to your external tools:
 - To retrieve deployment logs, use :ref:`atlas deployment logs <atlas-deployments-logs>`
   command in the {+atlas-cli+}. To learn more, see :atlas:`Atlas Deployment Logs </cli/current/command/atlas-deployments-logs/>`.
 
-Examples
---------
+Automation Examples: {+service+} Auditing and Logging
+-----------------------------------------------------
 
 .. include:: /includes/complete-examples.rst
 

source/auth.txt

@@ -1,17 +1,16 @@
 .. _arch-center-auth:
 
-================================
-Authorization and Authentication
-================================
+=========================================================
+Guidance for {+service+} Authorization and Authentication
+=========================================================
 
 .. default-domain:: mongodb
 
 .. facet::
    :name: genre
    :values: reference
 
-.. meta::
-   :keywords: atlas architecture center
+.. meta:   
    :description: Learn about the different authorization and authentication mechanisms that Atlas supports.
 
 .. contents:: On this page
@@ -43,11 +42,8 @@ authentication is distinct from authorization:
   user's access to database resources and operations. Outside of role
   assignments, the user has no access to the system.
 
-{+service+} Features and Recommendations for Authentication
------------------------------------------------------------
-
-Features 
-~~~~~~~~
+Features for {+service+} Authentication
+---------------------------------------
 
 |service-fullname| supports a variety of authentication methods to
 ensure robust security.   
@@ -66,8 +62,13 @@ authentication methods for each |service| resource ensure that
 authentication is both secure and adaptable. |service| provides the
 following authentication mechanisms:
 
-Recommendations for {+atlas-ui+}  
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. _arch-center-authentication-recs:
+
+Recommendations for {+service+} Authentication
+----------------------------------------------
+
+{+atlas-ui+} Authentication
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 We recommend federated authentication for {+atlas-ui+} access. To
 configure federated authentication, you must create {+service+}
@@ -104,7 +105,7 @@ from IP ranges that include your users and application servers.
 
 To learn more, see :ref:`atlas-federated-authentication`.
 
-Multi-Factor authentication 
+Multi-Factor Authentication 
 ```````````````````````````
 
 For any human user that has access to the |service| control plane, we recommend
@@ -124,8 +125,8 @@ two forms of identification:
 
 To learn more, see :ref:`atlas-enable-mfa`.
 
-Recommendations for |service| Database  
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+|service| Database Authentication 
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 |service| supports various database authentication mechanisms.
 
@@ -242,8 +243,8 @@ MongoDB Atlas Database Secrets in HashiCorp Vault
 
 .. _arch-center-admin-api-recs:
 
-Recommendations for {+atlas-admin-api+} 
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+{+atlas-admin-api+} Authentication
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 |service| provides two ways to authenticate to the {+atlas-admin-api+}:
 
@@ -289,16 +290,15 @@ minimize the risk of unauthorized access:
 
 To learn more, see :ref:`api-authentication`.
 
-Recommendations for Deployments 
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Deployments 
+~~~~~~~~~~~
 
 To learn our recommendations for deployments, which relate to authentication, see :ref:`arch-center-hierarchy`.
 
-{+service+} Features and Recommendations for Authorization 
-----------------------------------------------------------
+.. _arch-center-authorization-recs:
 
-Features 
-~~~~~~~~
+Recommendations for {+service+} Authorization 
+---------------------------------------------
 
 You must implement |service|'s robust Role-Based Access Control (RBAC) 
 to effectively manage access across all resources. |service| includes 
@@ -320,8 +320,8 @@ environments  to only programmatic service accounts with scripts that
 are tested for security and deterministic outcomes. Human access should 
 only be allowed in lower environments during development and testing.
 
-Recommendations for {+atlas-ui+} and {+atlas-admin-api+} (Control Plane)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+{+atlas-ui+} and {+atlas-admin-api+} (Control Plane) Authorization
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 You can assign users, service accounts, and API keys to predefined
 roles, specifying the
@@ -400,8 +400,8 @@ commonly used roles can serve as a general guideline:
 
 To learn more, see :ref:`user-roles`.
 
-Recommendations for Database 
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Database Authorization
+~~~~~~~~~~~~~~~~~~~~~~
 
 Workforce and workload users can be assigned fine-grained database
 roles, predefined or custom, with permissions tailored to specific
@@ -426,8 +426,8 @@ To learn more, see the following:
 - :ref:`mongodb-users-roles-and-privileges`
 - :ref:`mongodb-roles`
 
-Examples
---------
+Automation Examples: {+service+} Authentication and Authorization
+-----------------------------------------------------------------
 
 .. include:: /includes/complete-examples.rst
 

source/automation.txt

@@ -1,8 +1,8 @@
 .. _arch-center-automation:
 
-=====================================
-Automated Infrastructure Provisioning
-=====================================
+==============================================================
+Guidance for {+service+} Automated Infrastructure Provisioning
+==============================================================
 
 .. default-domain:: mongodb
 
@@ -11,7 +11,6 @@ Automated Infrastructure Provisioning
    :values: reference
 
 .. meta::
-   :keywords: atlas architecture center
    :description: Learn about the different Atlas tools to automate the provisioning and management of Atlas clusters and projects.
 
 .. contents:: On this page
@@ -31,11 +30,8 @@ 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
--------------------------------------------------------
-
-Features
-~~~~~~~~
+Features for Atlas Automation
+-----------------------------
 
 You can automate the management, provisioning, and configuration of
 |service| building blocks like database users and roles, |service|
@@ -52,7 +48,7 @@ deploy and manage |service| at scale with repeatable, accurate, and
 scalable processes. 
 
 {+atlas-admin-api+} 
-`````````````````````````````
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The {+atlas-admin-api+} provides a |rest|\ful interface that allows you
 to leverage your preferred client such as cURL or Postman to
@@ -65,7 +61,7 @@ To learn more, see :ref:`atlas-admin-api-access`.
 .. _arch-center-iac:
 
 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
@@ -95,7 +91,7 @@ applications quickly and easily.
 To learn more, see :ref:`Atlas Go SDK <atlas-admin-sdk>`.
 
 CloudFormation Resources
-````````````````````````
+~~~~~~~~~~~~~~~~~~~~~~~~
 
 Resources to manage |service| include:
 
@@ -110,7 +106,7 @@ Resources to manage |service| include:
 To learn more, see `Deploy MongoDB Atlas with AWS CloudFormation <https://www.mongodb.com/developer/products/atlas/deploy-mongodb-atlas-aws-cloudformation/>`__.
 
 {+atlas-cli+} 
-`````````````
+~~~~~~~~~~~~~
 
 Enables you to manually or programmatically create, manage, and automate
 tasks related to |service| resources from a unified command line tool.
@@ -126,7 +122,7 @@ examples in the {+atlas-arch-center+} such as the :ref:`Org, Project,
 and Cluster<arch-center-hierarchy>` examples to get started.
 
 |ak8so| 
-`````````````````````````
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Allows you to deploy and manage |service| resources using you existing
 Kubernetes tools. The Operator enables management of |service| through
@@ -135,8 +131,10 @@ configure |service|.
 
 To learn more, see :ref:`ak8so-quick-start-ref`. 
 
-Recommendations
-~~~~~~~~~~~~~~~
+.. _arch-center-automation-recs:
+
+Recommendations for {+service+} Automation
+------------------------------------------
 
 If you already have an existing tool integrated into your deployment
 workflow that you use today, we recommend that you use that tool for

source/backups.txt

@@ -1,8 +1,8 @@
 .. _arch-center-backups:
 
-=======
-Backups
-=======
+================================
+Guidance for {+service+} Backups
+================================
 
 .. default-domain:: mongodb
 
@@ -11,7 +11,6 @@ Backups
    :values: reference
 
 .. meta::
-   :keywords: atlas architecture center
    :description: Learn the best practices for configuring backups for you Atlas cluster.
 
 .. contents:: On this page
@@ -42,11 +41,8 @@ environments. For staging and production environments, we recommend
 developing automated deployment templates that include the
 recommendations described in this page. 
 
-{+service+} Features and Recommendations for Backups
-----------------------------------------------------
-
-Features
-~~~~~~~~
+Features for {+service+} Backups
+--------------------------------
 
 |service| provides fully-managed backups of your data, including
 point-in-time data recovery and consistent, cluster-wide snapshots of
@@ -99,6 +95,11 @@ monthly, each with its own retention period.
        and cooldown period so that an attacker cannot change the backup 
        policy and export the data. To learn more, see `Configure a Backup Compliance Policy <https://www.mongodb.com/docs/atlas/backup/cloud-backup/backup-compliance-policy/>`__.
 
+.. _arch-center-backups-recs:
+
+Recommendations for {+service+} Backups
+---------------------------------------
+
 Recommendations for Backup Strategy
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -244,8 +245,8 @@ right {+cluster+} disk size based on workload to prevent overspending.
 By implementing these strategies, you can effectively manage costs while
 maintaining secure and reliable backups.   
 
-Examples
---------
+Automation Examples: {+service+} Backups
+----------------------------------------
 
 .. include:: /includes/complete-examples.rst