OSDOCS#2948: Updates to the OCP quick start documentation

Author: opayne1

_topic_maps/_topic_map.yml

@@ -898,9 +898,14 @@ Topics:
     File: uninstalling-web-terminal
 - Name: Disabling the web console
   File: disabling-web-console
+Name: Quick starts
+  Dir: quick-starts
   Distros: openshift-enterprise,openshift-origin
-- Name: Creating quick start tutorials
-  File: creating-quick-start-tutorials
+  Topics:
+  - Name: Understanding quick start tutorials in the web console
+    File: Understanding-quick-starts-web-console
+    Name: Creating quick start tutorials
+    File: creating-quick-start-tutorials
   Distros: openshift-enterprise,openshift-origin
 - Name: Optional capabilities and products
   File: capabilities_products-web-console

modules/accessing-quick-starts.adoc

@@ -0,0 +1,20 @@
+// Module included in the following assemblies:
+//
+// * web_console/about-quick-start-tutorials.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="accessing-quick-starts_{context}"]
+= Accessing quick starts
+
+You can access quick starts under the *Getting started resources* pane on the *Overview* page of the web console.
+
+.Prerequisites
+* You have access to a {product-title} cluster with `cluster-admin` privledges. [Need to check and see if it is in dev console too]
+
+.Procedure
+
+. Log into the {product-title} web console using your credintials.
+
+. On the *Cluster Overview* page, navigate to the *Getting started resources* section and click *View all quick starts* under *Build with guided documentation*.
+
+. Once you are on the *Quick Starts* page, you can select a topic you would like step-by-step instructions and tasks for.

modules/quick-starts-accessing-and-executing-code-snippets.adoc

@@ -5,7 +5,9 @@
 [id="quick-starts-accessing-and-executing-code-snippets_{context}"]
 = Code snippet markdown reference
 
-You can execute a CLI code snippet when it is included in a quick start from the web console. To use this feature, you must first install the Web Terminal Operator. The web terminal and code snippet actions that execute in the web terminal are not present if you do not install the Web Terminal Operator. Alternatively, you can copy a code snippet to the clipboard regardless of whether you have the Web Terminal Operator installed or not.
+You can execute a CLI code snippet when it is included in a quick start from the web console. To use this feature, you can:
+* Install the Web Terminal Operator.
+* Copy a code snippet to the clipboard regardless of whether you have the Web Terminal Operator installed or not.
 
 [id="quick-starts-syntax-for-inline-code-snippets_{context}"]
 == Syntax for inline code snippets
@@ -15,11 +17,6 @@ You can execute a CLI code snippet when it is included in a quick start from the
 `code block`{{execute}}
 ----
 
-[NOTE]
-====
-If the `execute` syntax is used, the *Copy to clipboard* action is present whether you have the Web Terminal Operator installed or not.
-====
-
 [id="quick-starts-syntax-for-multi-line-code-snippets_{context}"]
 == Syntax for multi-line code snippets
 

modules/quick-starts-supported-tags.adoc

@@ -0,0 +1 @@
+../_attributes/

modules/understanding-quick-starts.adoc

@@ -17,13 +17,11 @@ toc::[]
 
 If you are creating quick start tutorials for the {product-title} web console, follow these guidelines to maintain a consistent user experience across all quick starts.
 
-include::modules/understanding-quick-starts.adoc[leveloffset=+1]
-
 include::modules/quick-start-user-workflow.adoc[leveloffset=+1]
 
 include::modules/quick-start-components.adoc[leveloffset=+1]
 
-// Hiding in ROSA/OSD, as dedicated-admins cannot create "consolequickstarts" resource 
+// Hiding in ROSA/OSD, as dedicated-admins cannot create "consolequickstarts" resource
 ifndef::openshift-rosa,openshift-dedicated[]
 include::modules/contributing-quick-starts.adoc[leveloffset=+1]
 
@@ -35,12 +33,16 @@ include::modules/quick-start-limiting-access.adoc[leveloffset=+2]
 
 include::modules/quick-starts-linking-to-others.adoc[leveloffset=+2]
 
-include::modules/quick-starts-supported-tags.adoc[leveloffset=+2]
-
 include::modules/quick-starts-highlighting-reference.adoc[leveloffset=+2]
 
 include::modules/quick-starts-accessing-and-executing-code-snippets.adoc[leveloffset=+2]
 
+//[id="quick-start-code-snippet-additional-resources"]
+//[role="_additional-resources"]
+//== Additional resources
+
+//* xref:../web terminal operator
+
 include::modules/quick-start-content-guidelines.adoc[leveloffset=+1]
 
 [id="quick-start-tutorials-additional-resources"]
@@ -50,3 +52,4 @@ include::modules/quick-start-content-guidelines.adoc[leveloffset=+1]
 * For voice and tone requirements, refer to link:https://www.patternfly.org/v4/ux-writing/brand-voice-and-tone[PatternFly's brand voice and tone guidelines].
 * For other UX content guidance, refer to all areas of link:https://www.patternfly.org/v4/ux-writing/about[PatternFly's UX writing style guide].
 endif::openshift-rosa,openshift-dedicated[]
+* For a cheat sheet of supported markdown tags, refer to link:https://www.markdownguide.org/cheat-sheet/[Markdwon Cheat Sheet].

web_console/quick-starts/_attributes

@@ -0,0 +1 @@
+../images/

web_console/creating-quick-start-tutorials.adoc renamed to web_console/quick-starts/creating-quick-start-tutorials.adoc

@@ -0,0 +1 @@
+../modules/

web_console/quick-starts/images

@@ -0,0 +1 @@
+../snippets

web_console/quick-starts/modules

@@ -0,0 +1,13 @@
+:_mod-docs-content-type: ASSEMBLY
+[id="creating-quick-start-tutorials"]
+= Understanding quick start tutorials in the web console
+include::_attributes/common-attributes.adoc[]
+:context: understanding-quick-start-tutorials
+
+toc::[]
+
+A quick start is a guided tutorial with user tasks in the {product-title} web console. They are especially useful for getting oriented with an application, Operator, or other product offering.
+
+A quick start primarily consists of tasks and steps. Each task has multiple steps, and each quick start has multiple tasks.
+
+include::modules/accessing-quick-starts.adoc[leveloffset=+1]