RHDEVDOCS 6162 edits to remove workspaces from StepAction description…

…s and improve style

templates/common-params.tpl

@@ -8,8 +8,7 @@
   type: string
   default: ca-bundle.crt
   description: |
-    Certificate Authority (CA) bundle filename on the `ssl-ca-directory`
-    Workspace.
+    Certificate Authority (CA) bundle filename in the SSL CA directory.
 - name: HTTP_PROXY
   type: string
   default: ""
@@ -29,7 +28,8 @@
   type: string
   default: ""
   description: |
-    Relative path to the default Workspace where the git repository will be present.
+    Path to the directory for storing the cloned Git repository, relative to the
+    output directory.
 - name: USER_HOME
   type: string
   default: "/home/git"
@@ -39,16 +39,16 @@
   type: string
   default: "true"
   description: |
-    Clean out the contents of the default Workspace before specific git operations occur, if data exists.
+    Clean out the contents of the default Workspace before specific Git operations occur, if data exists.
 - name: VERBOSE
   type: string
   default: "false"
   description: |
-    Log the commands executed.
+    Log the executed commands.
 - name: SSL_VERIFY
   type: string
   default: "true"
   description: |
     Sets the global `http.sslVerify` value, `false` is not advised unless
     you trust the remote repository.
-{{- end -}}
+{{- end -}}

templates/stepaction-params-git-clone.tpl

@@ -1,9 +1,9 @@
 {{- define "stepaction_params_git_clone" -}}
 - name: OUTPUT_PATH
   description: |
-    A workspace that contains the fetched git repository, data will be placed on the root of the
-    Workspace, or on the relative path defined by the SUBDIRECTORY
-    parameter.
+    A directory that contains the fetched git repository. Cloned repo data is
+    placed in the root of the directory or in the relative path defined by the
+    `SUBDIRECTORY` parameter
 - name: SSH_DIRECTORY_PATH
   description: |
     A `.ssh` directory with private key, `known_hosts`, `config`, etc.
@@ -14,15 +14,15 @@
 - name: BASIC_AUTH_PATH
   default: "no-path"
   description: |
-    A Workspace containing a `.gitconfig` and `.git-credentials` files.
-    These will be copied to the user's home before Git commands run. All
-    other files in this Workspace are ignored. It is strongly recommended to
+    A directory containing `.gitconfig` and `.git-credentials` files.
+    These files are copied to the user home directory before Git commands run.
+    All other files in this Workspace are ignored. It is strongly recommended to
     use `ssh-directory` over `basic-auth` whenever possible, and to bind a
-    Secret to this Workspace over other volume types.
+    Secret to the Workspace providing this directory.
 - name: SSL_CA_DIRECTORY_PATH
   default: "no-path"
   description: |
-    A Workspace containing CA certificates, this will be used by Git to
+    A directory containing CA certificates. Git uses these certificates to
     verify the peer with when interacting with remote repositories using
     HTTPS.
-{{- end -}}
+{{- end -}}