DOCSP-30693: update release notes with breaking changes (#154)

* DOCSP-30693: update release notes with breaking changes

* tech review feedback

* added jq template

* DOCSP-30760: 1.7.4 release notes

* set submodule to v1.7.4

Author: jwilliams-mongo

snooty.toml

@@ -27,7 +27,7 @@ toc_landing_pages = [
 aagent = "Automation Agent"
 atlas-cli = "Atlas CLI"
 atlas-cli-full = "MongoDB Atlas CLI"
-atlas-cli-version = "1.7.3"
+atlas-cli-version = "1.7.4"
 ak8so = "Atlas Kubernetes Operator"
 cloudgov = ":atlas:`MongoDB Atlas for Government </government>`"
 cloudgov-short = "AtlasGov"

source/atlas-cli-changelog.txt

@@ -14,6 +14,32 @@
    :depth: 1
    :class: singlecol
 
+.. _atlas-cli-1.7.4:
+
+{+atlas-cli+} 1.7.4
+-------------------
+
+Released 15 June 2023
+
+- Adds the ``--compact`` flag to compact the output of specific ``list`` 
+  commands. This ensures backwards compatibility with {+atlas-cli+} 
+  releases prior to 1.7.0.
+  
+  Use this flag with the ``--output json`` or ``--output json-format`` 
+  flags to return an array that contains list items as output for the
+  following commands:
+
+  - :ref:`atlas-teams-list`
+  - :ref:`atlas-dbusers-certs-list`
+  - :ref:`atlas-dbusers-list`
+  - :ref:`atlas-projects-apiKeys-list`
+  - :ref:`atlas-organizations-apiKeys-list`
+  - :ref:`atlas-projects-users-list`
+  - :ref:`atlas-processes-list`
+  - :ref:`atlas-alerts-settings-list`
+
+- Introduces custom handling for valid ISO-8601 timestamps.
+
 .. _atlas-cli-1.7.3:
 
 {+atlas-cli+} 1.7.3
@@ -32,6 +58,17 @@ Released 9 June 2023
 
 Released 7 June 2023
 
+- Introduces a breaking change to the :ref:`atlas-alerts-settings-list`
+  command that modifies its ``--output json`` response structure.
+  
+  Use the nested ``.results`` object to access the previous response
+  structure. Use the following ``jq`` template to migrate affected 
+  scripts:
+  
+  .. code-block:: sh
+    
+     jq '.' ...`` => ``jq '.results' ...
+
 - Fixes an issue that caused the :ref:`atlas-clusters-search-indexes-create` command to 
   incorrectly handle a multikey index.
 - Fixes an issue with the :ref:`atlas-performanceAdvisor-slowQueryLogs` command where the
@@ -59,6 +96,25 @@ Released 31 May 2023
 
 Released 25 May 2023
 
+- Introduces a breaking change to the following commands
+  that modifies their ``--output json`` response structures:
+
+  - :ref:`atlas-teams-list`
+  - :ref:`atlas-dbusers-certs-list`
+  - :ref:`atlas-dbusers-list`
+  - :ref:`atlas-projects-apiKeys-list`
+  - :ref:`atlas-organizations-apiKeys-list`
+  - :ref:`atlas-projects-users-list`
+  - :ref:`atlas-processes-list`
+  
+  Use the nested ``.results`` object to access the previous response
+  structure. Use the following ``jq`` template to migrate affected 
+  scripts:
+  
+  .. code-block:: sh
+    
+     jq '.' ...`` => ``jq '.results' ...
+
 - Adds the :ref:`atlas-kubernetes-operator-install` command to install
   the :atlas:`{+ak8so+} </atlas-operator>`.