Merge pull request #37214 from bergerhoffer/adding-jq-guidance

Author: adellape

contributing_to_docs/doc_guidelines.adoc

@@ -934,6 +934,20 @@ spec:
 +
 Do not use `[...]`, `<snip>`, or any other variant.
 
+* Do not use `jq` in commands (unless it is truly required), because this requires users to install the `jq` tool. Oftentimes, the same or similar result can be accomplished using `jsonpath` for `oc` commands.
++
+For example, this command that uses `jq`:
++
+----
+$ oc get clusterversion -o json|jq ".items[0].spec"
+----
++
+can be updated to use `jsonpath` instead:
++
+----
+$ oc get clusterversion -o jsonpath='{.items[0].spec}{"\n"}'
+----
+
 === Inline code or commands
 Do NOT show full commands or command syntax inline within a sentence. The next section covers how to show commands and command syntax.