DOCSP-11566 allow for users to define their go template (#214)

* DOCSP-11566 allow for users to define their go template

DOCSP-11566 self-review

* DOCSP-11566 updates for tech review feedback

* Update source/configure/go-template-output.txt

Co-authored-by: jwilliams-mongo <[email protected]>

* DOCSP-11566 update for self-review

Co-authored-by: jwilliams-mongo <[email protected]>

Author: kanchana-mongodb

source/configure.txt

@@ -20,6 +20,7 @@ Configure the {+mcli+}
       /configure/configuration-file
       /configure/environment-variables
       /configure/autocomplete
+      /configure/go-template-output
 
 You can define the settings that the {+mcli+} uses to interact with
 MongoDB services like |service|, |cloud-short|, and |onprem| by using

source/configure/go-template-output.txt

@@ -0,0 +1,79 @@
+.. _go-template-output: 
+
+====================================================
+Customize the {+mcli+} Output Using a Go Template
+====================================================
+
+You can customize the {+mcli+} output fields and format using a ``Go`` 
+template. The template can be specified with the command for a simple output 
+or through a separate file for a complex output. For information on the 
+template, see `Package template <https://golang.org/pkg/text/template/>`__. 
+For information on the types and properties available for each response, see: 
+
+- `Atlas types <https://go.mongodb.org/atlas/mongodbatlas/>`__
+- `Clour Manager types <https://go.mongodb.org/ops-manager/opsmngr/>`__
+- `Ops Manager types <https://go.mongodb.org/ops-manager/opsmngr/>`__
+
+Syntax 
+------
+
+You can specify a template with the command using the ``--output`` or 
+``-o`` option: 
+
+.. code-block:: shell 
+   :copyable: false 
+
+   --output|-o go-template="{{<template>}}"
+
+You can specify a template using a file using the ``--output`` or 
+``-o`` option: 
+
+.. code-block:: shell 
+   :copyable: false 
+
+   --output|-o go-template-file="<path-to-template-file>"
+
+Examples 
+--------
+
+.. tabs:: 
+
+   .. tab:: Specify Template With the Command
+
+      For example, the following command uses the template to retrieve a 
+      count of the number of projects in the specified organization using the 
+      {+default-profile+}:
+
+      .. code-block:: shell 
+       
+         mongocli iam projects ls --orgId 5ab5cedf5g5h5i5j5kl12mn4 -o go-template="Count: {{.TotalCount}}"
+
+      The preceding command returns the following output: 
+
+      .. code-block:: shell 
+         :copyable: false 
+
+         Count: 2
+   
+   .. tab:: Specify Template Using a File
+
+      For example, consider the following file named ``template.tmpl``: 
+
+      .. code-block:: shell 
+
+         Projects: {{range .Results}}{{.ID}} {{end}}
+      
+      The following command uses the ``template.tmpl`` file to retrieve 
+      the IDs of the projects in the specified organization using the 
+      {+default-profile+}:
+
+      .. code-block:: shell 
+       
+         mongocli iam projects ls --orgId 5ab5cedf5g5h5i5j5kl12mn4 -o go-template-file="template.tmpl"
+
+      The preceding command returns the following output: 
+
+      .. code-block:: shell 
+         :copyable: false 
+
+         Projects: 5e2211c17a3e5a48f5497de3 5f455b39749bea5fb575dccc

source/includes/extracts-basic-options.yaml

@@ -1,7 +1,14 @@
 ref: fact-basic-options-output
 content: | 
-  Command output format. Specify ``json`` for output in |json| format. If 
-  omitted, each command returns output in the default format.
+  Command output format. Valid values are: 
+  
+  - ``json`` for output in |json| format 
+  - ``go-template`` for custom output using the :ref:`Go template 
+    <go-template-output>`
+  - ``go-template-file`` for custom output specified using :ref:`Go 
+    template <go-template-output>` file
+  
+  If omitted, the command returns output in the default format.
 ---
 ref: fact-basic-options-profile
 content: |