From f4bd1493ff93b93e51439b8003d7d4f894f6fda0 Mon Sep 17 00:00:00 2001
From: "K.B.Dharun Krishna" <kbdharunkrishna@gmail.com>
Date: Mon, 4 Dec 2023 10:02:48 +0530
Subject: [PATCH] gcloud-*: update pages

Signed-off-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>
---
 pages/common/gcloud-config.md    |  5 +++--
 pages/common/gcloud-container.md | 25 +++++++++++++++++++++++++
 pages/common/gcloud-docker.md    | 24 ------------------------
 pages/common/gcloud-feedback.md  | 13 +++++++++++++
 pages/common/gcloud-help.md      | 14 +++++---------
 5 files changed, 46 insertions(+), 35 deletions(-)
 create mode 100644 pages/common/gcloud-container.md
 delete mode 100644 pages/common/gcloud-docker.md
 create mode 100644 pages/common/gcloud-feedback.md

diff --git a/pages/common/gcloud-config.md b/pages/common/gcloud-config.md
index f5d3239ff5..4d06928efa 100644
--- a/pages/common/gcloud-config.md
+++ b/pages/common/gcloud-config.md
@@ -1,13 +1,14 @@
 # gcloud config
 
-> Personalize your `gcloud` CLI configuration with properties.
+> Personalize your `gcloud` configuration with properties.
+> See also: `gcloud`.
 > More information: <https://cloud.google.com/sdk/gcloud/reference/config>.
 
 - Define a property (like compute/zone) for the current configuration:
 
 `gcloud config set {{property}} {{value}}`
 
-- Fetch the value of a gcloud CLI property:
+- Fetch the value of a `gcloud` property:
 
 `gcloud config get {{property}}`
 
diff --git a/pages/common/gcloud-container.md b/pages/common/gcloud-container.md
new file mode 100644
index 0000000000..313001dee0
--- /dev/null
+++ b/pages/common/gcloud-container.md
@@ -0,0 +1,25 @@
+# gcloud container
+
+> Manage containerized applications on Kubernetes and clusters.
+> See also: `gcloud`.
+> More information: <https://cloud.google.com/sdk/gcloud/reference/container>.
+
+- Register `gcloud` as a Docker credential helper:
+
+`gcloud auth configure-docker`
+
+- Create a cluster to run GKE containers:
+
+`gcloud container clusters create {{cluster_name}}`
+
+- List clusters for running GKE containers:
+
+`gcloud container clusters list`
+
+- Update kubeconfig to get `kubectl` to use a GKE cluster:
+
+`gcloud container clusters get-credentials {{cluster_name}}`
+
+- List tag and digest metadata for a container image:
+
+`gcloud container images list-tags {{image}}`
diff --git a/pages/common/gcloud-docker.md b/pages/common/gcloud-docker.md
deleted file mode 100644
index 6b92a4391f..0000000000
--- a/pages/common/gcloud-docker.md
+++ /dev/null
@@ -1,24 +0,0 @@
-# gcloud cli docker and google kubernetes engine
-
-> Manage containerized applications on Kubernetes.
-> More information: <https://cloud.google.com/sdk/docs/cheatsheet#docker>.
-
-- Register the gcloud CLI as a Docker credential helper:
-
-`gcloud auth configure-docker`
-
-- Create a cluster to run GKE containers:
-
-`gcloud container clusters create`
-
-- List clusters for running GKE containers:
-
-`gcloud container clusters list`
-
-- Update kubeconfig to get kubectl to use a GKE cluster:
-
-`gcloud container clusters get-credentials`
-
-- List tag and digest metadata for a container image:
-
-`gcloud container images list-tags`
diff --git a/pages/common/gcloud-feedback.md b/pages/common/gcloud-feedback.md
new file mode 100644
index 0000000000..b09d52ba5a
--- /dev/null
+++ b/pages/common/gcloud-feedback.md
@@ -0,0 +1,13 @@
+# gcloud help
+
+> Provide feedback to the Google Cloud team.
+> See also: `gcloud`.
+> More information: <https://cloud.google.com/sdk/gcloud/reference/feedback>.
+
+- Provide feedback to the `gcloud` team:
+
+`gcloud feedback`
+
+- Provide feedback to the `gcloud` team, including a log file:
+
+`gcloud feedback --log-file {{log_file}}`
diff --git a/pages/common/gcloud-help.md b/pages/common/gcloud-help.md
index 456e077e17..a9a0fc7d05 100644
--- a/pages/common/gcloud-help.md
+++ b/pages/common/gcloud-help.md
@@ -1,16 +1,12 @@
-# gcloud cli help
+# gcloud help
 
-> Display help information and support for `gcloud`.
-> More information: <https://cloud.google.com/sdk/docs/cheatsheet#help>.
+> Display help and reference information for `gcloud`.
+> More information: <https://cloud.google.com/sdk/gcloud/reference/help>.
 
-- Search the gcloud CLI reference documents for specific terms:
+- Search the `gcloud` CLI reference documents for specific terms:
 
 `gcloud help`
 
-- Provide feedback to the gcloud CLI team:
-
-`gcloud feedback`
-
-- Supplementary help material for non-command topics like accessibility, filtering, and formatting:
+- View supplementary help material for non-command topics like accessibility, filtering, and formatting:
 
 `gcloud topic`