Merge pull request #3914 from zowe/anax-v3-whatsnew-reorg-docs

relocating items in what's new section; editing for style, consistency

docs/appendix/zowe-glossary.md

@@ -1,4 +1,4 @@
-# Glossary of Zowe terminology
+# Zowe glossary
 
 This glossary is part of a growing list of terms and concepts used throughout the spectrum of Zowe  projects, which includes both technical as well as organizational terms that are specific to Zowe.
 

docs/extend/migrate-extensions.md

@@ -1,4 +1,4 @@
-# Migrating Zowe server component from V1 to V2
+# Migrating from Zowe V1 to Zowe V2
 
 This doc guides you through migrating an existing Zowe server component from version 1 to version 2. 
 

docs/getting-started/zowe-office-hours.md

@@ -1,4 +1,4 @@
-# Zowe V2 office hours videos
+# Zowe V2 Office Hours
 
 Watch the series of Zowe office hours videos to learn more about the new features and enhancements in Zowe Version 2 release.
 

docs/getting-started/zowe-resources.md

@@ -13,63 +13,60 @@ Want to contribute a blog? Details for how to contribute to the [Zowe blogs on M
 
 <iframe class="embed-responsive-item" id="youtubeplayer" title="Zowe videos" type="text/html" width="100%" height="365" src="https://www.youtube.com/embed?listType=playlist&list=PL8REpLGaY9QE_9d57tw3KQdwSVLKuTpUZ" frameborder="0" webkitallowfullscreen="true" mozallowfullscreen="true" allowfullscreen="true"> </iframe>
 
-As well as [Zowe videos](https://www.youtube.com/embed?listType=playlist&list=PL8REpLGaY9QE_9d57tw3KQdwSVLKuTpUZ) owned and managed by the community, there are a number of external youtubers who host Zowe related content. 
+As well as [Zowe videos](https://www.youtube.com/embed?listType=playlist&list=PL8REpLGaY9QE_9d57tw3KQdwSVLKuTpUZ) owned and managed by the community, there are a number of external YouTubers who host Zowe related content.
 
 - [Zowe Demos playlist from Bill Pereira](https://www.youtube.com/playlist?list=PLM85SdWDWtebJ13Kww8rxKlDlWe72D7b3)
 - [Mainframe Bytes channel from Jessielaine Punongbayan](https://www.youtube.com/channel/UCZrvxFwT1GpvJuFRyqc5uWg)
 
-
 ## Webinars
 
-Find out what's happening with Zowe in the Zowe Quarterly Update Webinar Series.
+Find out what is happening with Zowe in the Zowe Quarterly Update Webinar Series.
 
 - [Zowe Quarterly Update Webinar: October 2021](https://youtu.be/b0Xo6WIy3vc)
 - [Zowe Quarterly Update Webinar: July 2021](https://youtu.be/T3Z4hMwElII)
 - [Zowe Quarterly Update Webinar: April 2021](https://youtu.be/9rQCcZGVDzQ)
 - [Zowe Quarterly Update Webinar: January 2021](https://youtu.be/ZEwd8wZvbIw)
 - [Zowe Quarterly Update Webinar: October 2020](https://youtu.be/GbAFO5vzBhw)
 
-The [OMP Youtube channel](https://www.youtube.com/channel/UC-WTXQQtz2m5iTflJLK59aw/videos) also offers other webinars about Zowe. 
+The [OMP Youtube channel](https://www.youtube.com/channel/UC-WTXQQtz2m5iTflJLK59aw/videos) also offers other webinars about Zowe.
+
 - [Treat Yourself to a Guided, Comprehensive Tour of Zowe Desktop Applications](https://youtu.be/cbEVbcsaGCs)
 - [Zowe Webinar Feb. 22, 2019](https://youtu.be/XixEltbRmds)
 - [Open Mainframe Project Webinar: Zowe Virtual Hackathon](https://youtu.be/zIPzaQK2bfU)
 
-
 ## Community
 
-**Join us on Slack** 
+### Join us on Slack
 
 - [Slack invite link](https://slack.openmainframeproject.org/)  
 - [Introduction to Zowe Slack channels](https://github.com/zowe/community/blob/master/README.md#slack)
 
-**Learn more about the community**
+### Learn more about the community
 
 - [Zowe community GitHub repo](https://github.com/zowe/community/blob/master/README.md)
 
-   Find out information about Zowe sub-projects, GitHub repos, mailing lists, community meeting minutes, contribution guidelines, and so on. 
+   Find out information about Zowe sub-projects, GitHub repos, mailing lists, community meeting minutes, contribution guidelines, and so on.
 
-**Connect with the community through meetings** 
+### Connect with the community through meetings
 
 - [Zowe meeting calendar](https://zoom-lfx.platform.linuxfoundation.org/meetings/zowe)
 
    You can join one of the Zowe meetings to get latest Zowe updates and get involved in different squads and initiatives.
 
 ## Training
 
-**Courses**
+### Courses
 
 - [Zowe Fundamentals](https://interskill.com/course/zowe-foundations/)
 
   Interskill Learning offers a free training course that introduces the components that comprise Zowe and the benefits of using Zowe and how its capabilities can be extended. 
 
-**Trials**
+### Trials
 
 - [Zowe trial](https://early-access.ibm.com/software/support/trial/cst/welcomepage.wss?siteId=936&tabId=2216&w=1&mhsrc=ibmsearch_a&mhq=Zowe%20trial)
 
-   The Zowe trial hosted by IBM is a fully configured z/OS environment with Zowe preinstalled and set up along with a set of integrated easy-to-follow tutorials that walk you through the basics of Zowe and gives you hands-on experience of extending Zowe. This no-charge trial is available in two hours for three days. 
+   The Zowe trial hosted by IBM is a fully configured z/OS environment with Zowe preinstalled and set up along with a set of integrated easy-to-follow tutorials that walk you through the basics of Zowe and gives you hands-on experience of extending Zowe. This no-charge trial is available in two hours for three days.
 
 - [Get started with the Zowe Web UI](https://developer.ibm.com/components/ibmz/tutorials/zowe-step-by-step-tutorial/)
-
-   This online tutorial hosted by IBM guides you to add new apps to the Zowe Web UI. It provides a public hosted Zowe instance that allows you to perform the steps in a z/OS environment. 
-
 
+   This online tutorial hosted by IBM guides you to add new apps to the Zowe Web UI. It provides a public hosted Zowe instance that allows you to perform the steps in a z/OS environment.

docs/getting-started/zowe-v2-overview.md

@@ -0,0 +1,27 @@
+# Important updates in Zowe V2
+
+Zowe V2 is now in maintenance state. Only [patch releases](https://github.com/zowe/community/blob/master/Project%20Management/Schedule/Zowe%20PI%20%26%20Sprint%20Cadence.md#v2) are planned until the Zowe V2 End of Service scheduled for early 2027.
+
+Review enhancements introduced in previous releases:
+
+- [Zowe v2.18.0 (August 2024)](../whats-new/release-notes/v2_18_0)
+- [Zowe v2.17.0 (July 2024)](../whats-new/release-notes/v2_17_0)
+- [Zowe v2.16.0 (May 2024)](../whats-new/release-notes/v2_16_0)
+- [Zowe v2.15.0 (March 2024)](../whats-new/release-notes/v2_15_0)
+- [Zowe v2.14.0 (January 2024)](../whats-new/release-notes/v2_14_0)
+- [Zowe v2.13.0 (December 2023)](../whats-new/release-notes/v2_13_0)
+- [Zowe v2.12.0 (October 2023)](../whats-new/release-notes/v2_12_0)
+- [Zowe v2.11.0 (September 2023)](../whats-new/release-notes/v2_11_0)
+- [Zowe v2.10.0 (July 2023)](../whats-new/release-notes/v2_10_0)
+- [Zowe v2.9.0 (June 2023)](../whats-new/release-notes/v2_9_0)
+- [Zowe v2.8.0 (April 2023)](../whats-new/release-notes/v2_8_0)
+- [Zowe v2.7.0 (March 2023)](../whats-new/release-notes/v2_7_0)
+- [Zowe v2.6.1 (February 2023)](../whats-new/release-notes/v2_6_1)
+- [Zowe v2.6.0 (January 2023)](../whats-new/release-notes/v2_6_0)
+- [Zowe v2.5.0 (December 2022)](../whats-new/release-notes/v2_5_0)
+- [Zowe v2.4.0 (October 2022)](../whats-new/release-notes/v2_4_0)
+- [Zowe v2.3.1 (September 2022)](../whats-new/release-notes/v2_3_1)
+- [Zowe v2.3.0 (September 2022)](../whats-new/release-notes/v2_3_0)
+- [Zowe v2.2.0 (July 2022)](../whats-new/release-notes/v2_2_0)
+- [Zowe v2.1.0 (June 2022)](../whats-new/release-notes/v2_1_0)
+- [Zowe v2.0.0 (April 2022)](../whats-new/release-notes/v2_0_0)

docs/getting-started/zowe_faq.md

@@ -1,4 +1,4 @@
-# Zowe FAQ
+# Zowe FAQs
 
 Check out the following FAQs to learn more about the purpose and function of Zowe™.
 

docs/getting-started/zowe_v2_faq.md

@@ -1,4 +1,4 @@
-# Zowe V2 FAQ
+# Zowe V2 FAQs
 
 ## Where can I find the V1 and V2 LTS conformance criteria? 
 

docs/whats-new/zowe-announcements.md

@@ -6,6 +6,8 @@
 
 For information about changes to Zowe components introduced in Zowe V3, see [Important updates in Zowe V3](breaking-changes-v3.md). For more details, review the [Zowe V3 release notes](release-notes/v3_0_0.md).
 
+Got questions? Check the [Zowe V3 FAQs](..//whats-new/zowe-v3-frequently-asked-questions.md) to see if it is already answered.
+
 ## Future Zowe V2 releases
 
 Zowe 2.0.x is now in maintenance state. Only [patch releases](https://github.com/zowe/community/blob/master/Project%20Management/Schedule/Zowe%20PI%20%26%20Sprint%20Cadence.md#v2) are planned until the Zowe V2 End of Service scheduled for early 2027.

docs/whats-new/zowe-v3-frequently-asked-questions.md

@@ -1,34 +1,24 @@
-# Zowe V3 Frequently Asked Questions
-
-## General questions
-
-1. When will Zowe V3 be released?
-
-   Zowe V3 is scheduled to be released on Sept. 28, 2024. Any changes to the plan will be communicated via all available channels.
-
-2. When will Zowe V3 be available for preview?
-
-   Currently, Zowe V3 pre-release versions are available for the PAX, Zowe CLI, Zowe Client Node.js SDKs, Zowe Explorer for Visual Studio Code, and the Zowe IntelliJ Plug-in.
+# Zowe V3 FAQs
 
 ## Extender questions
 
 ### API Mediation Layer
 
 1. Do we need to move away from PassTickets as the method of authentication to the API Mediation Layer?
 
-   No, we will continue to support PassTickets. However, PassTickets will be deprecated in Zowe V3, and are no longer recommended due to the inefficiency of configuration wherein users must configure a PassTicket for every service that uses them. 
+   No, we will continue to support PassTickets. However, PassTickets are deprecated in Zowe V3, and are no longer recommended due to the inefficiency of configuration wherein users must configure a PassTicket for every service that uses them. 
 
 2. With the introduction of the new cloud gateway, how is the configuration going to change?
 
-   The cloud gateway configuration for V3 will move to the currently used gateway configuration space (For example, `zowe.components.gateway`).The configuration that was Zuul specific will be removed and replaced with the Spring Cloud Gateway configuration.
+   The cloud gateway configuration for V3 has moved to the currently used gateway configuration space (For example, `zowe.components.gateway`). The configuration that was Zuul specific has been removed and replaced with the Spring Cloud Gateway configuration.
 
 3. How does client certificate authentication work in Zowe V3?
 
    Northbound authentication accepts client certificates. The API Mediation Layer then transforms the client certificate to another method of authentication (such as a JWT token, SAF IDT, or PassTicket). This new method is then accepted by southbound services. Currently, we do not plan to support authentication with client certificates to z/OSMF.
 
 4. Will you identify deprecated functionality such as PassTickets?
 
-   PassTickets will be deprecated in V3, but they will still be supported, possibly even through to Zowe V4.
+   PassTickets will be deprecated in V3, but PassTickets will still be supported, possibly even through to Zowe V4.
 
    We plan to identify all deprecated functionality. We will announce how this functionality will be identified in the near future.
 
@@ -82,9 +72,9 @@
 
 ### Zowe API Mediation Layer
 
-1. Will Zowe V3 API ML support clients with the V2 onboarding enabler?
+1. Does Zowe V3 API ML support clients with the V2 onboarding enabler?
 
-   The API ML in Zowe V3 supports clients with onboarding enablers from Zowe V2. It also works the other way around: The onboarding enablers from Zowe V3 will continue working with Zowe V2 API ML.
+   The API ML in Zowe V3 supports clients with onboarding enablers from Zowe V2. It also works the other way around: The onboarding enablers from Zowe V3 continue to work with Zowe V2 API ML.
 
 2. The jump to Java 17 means that we have to maintain two separate versions of our application, one with apiml-enabler V2 and one with V3, to support customers who want to stay with Java 8. Do you have a recommendation or a workaround for supporting both Java versions?
 
@@ -94,7 +84,7 @@
 
 3. Can you speak about the migration from Zuul to Spring Cloud Gateway? Today there are two separate gateway services in API ML with separate configurations.
 
-   Spring Cloud Gateway is replacing Zuul as the technology to provide the API Gateway. The configuration for the API Gateway remains in the `components.gateway` namespace. If you were using Spring Cloud Gateway in V2 for the multi-tenancy scenario, you need to update the configuration for the central gateway and move this configuration from `components.cloud-gateway` to `components.gateway`.
+   In Zowe V3, Spring Cloud Gateway has replaced Zuul as the technology to provide the API Gateway. The configuration for the API Gateway remains in the `components.gateway` namespace. If you were using Spring Cloud Gateway in V2 for the multi-tenancy scenario, you need to update the configuration for the central gateway and move this configuration from `components.cloud-gateway` to `components.gateway`.
 
 4. If I have a legacy gateway deployed, how will I migrate to the new gateway? Will the old gateway be removed?
 

sidebars.js

@@ -9,37 +9,35 @@ module.exports = {
       link: {type:"doc", id:"whats-new/release-notes/release-notes-overview"},
       items: [
         "whats-new/release-notes/v3_0_0",
-        "whats-new/release-notes/v2_18_0",
-        "whats-new/release-notes/v2_17_0",
-        "whats-new/release-notes/v2_16_0",
-        "whats-new/release-notes/v2_15_0",       
-        "whats-new/release-notes/v2_14_0",
-        "whats-new/release-notes/v2_13_0",
-        "whats-new/release-notes/v2_12_0",
-        "whats-new/release-notes/v2_11_0",
-        "whats-new/release-notes/v2_10_0",
-        "whats-new/release-notes/v2_9_0",
-        "whats-new/release-notes/v2_8_0",
-        "whats-new/release-notes/v2_7_0",
-        "whats-new/release-notes/v2_6_1",
-        "whats-new/release-notes/v2_6_0",
-        "whats-new/release-notes/v2_5_0",
-        "whats-new/release-notes/v2_4_0",
-        "whats-new/release-notes/v2_3_1",
-        "whats-new/release-notes/v2_3_0",
-        "whats-new/release-notes/v2_2_0",
-        "whats-new/release-notes/v2_1_0",
-        "whats-new/release-notes/v2_0_0",
-      ],
-    },
-    {
-      type: "category", // doc(default), 'link'(external links), 'ref'(page without without sidebar)
-      label: "Get to know Zowe V3",
-      link: {type:"doc", id:"whats-new/breaking-changes-v3"},
-      items: [
-        "whats-new/zowe-v3-office-hours",
-        "whats-new/zowe-v3-conformance-criteria",
-        "whats-new/zowe-v3-frequently-asked-questions",
+        {
+          type: "category", // doc(default), 'link'(external links), 'ref'(page without without sidebar)
+          label: "Zowe V2 release notes",
+          className: "ToCheadercolor",
+          collapsed: false,
+          items: [
+            "whats-new/release-notes/v2_18_0",
+            "whats-new/release-notes/v2_17_0",
+            "whats-new/release-notes/v2_16_0",
+            "whats-new/release-notes/v2_15_0",       
+            "whats-new/release-notes/v2_14_0",
+            "whats-new/release-notes/v2_13_0",
+            "whats-new/release-notes/v2_12_0",
+            "whats-new/release-notes/v2_11_0",
+            "whats-new/release-notes/v2_10_0",
+            "whats-new/release-notes/v2_9_0",
+            "whats-new/release-notes/v2_8_0",
+            "whats-new/release-notes/v2_7_0",
+            "whats-new/release-notes/v2_6_1",
+            "whats-new/release-notes/v2_6_0",
+            "whats-new/release-notes/v2_5_0",
+            "whats-new/release-notes/v2_4_0",
+            "whats-new/release-notes/v2_3_1",
+            "whats-new/release-notes/v2_3_0",
+            "whats-new/release-notes/v2_2_0",
+            "whats-new/release-notes/v2_1_0",
+            "whats-new/release-notes/v2_0_0",
+          ],
+        },
       ],
     },
   ],
@@ -74,37 +72,37 @@ module.exports = {
         "getting-started/zowe-high-availability"
       ],
     },
-    "appendix/zowe-glossary",
+  "getting-started/zowe_faq",
+  "appendix/zowe-glossary", 
+  "getting-started/zowe-resources",
     {
-      type: "category",
-      label: "Zowe FAQ",
-      className: "ToCheadercolor",
-      link: {type: "doc", id: "getting-started/zowe_faq"},
+      type: "category", // doc(default), 'link'(external links), 'ref'(page without without sidebar)
+      label: "Zowe V3",
+      link: {type:"doc", id:"whats-new/breaking-changes-v3"},
       items: [
-        "getting-started/zowe_v2_faq",
+        "whats-new/zowe-v3-frequently-asked-questions",
+        "whats-new/zowe-v3-office-hours",
+        "whats-new/zowe-v3-conformance-criteria",
       ],
     },
-    "getting-started/zowe-office-hours",
-    {
-      type: "doc",
-      label: "Zowe CLI quick start",
-      className: "ToCitemcolor",
-      id:"getting-started/cli-getting-started",
-    },
     {
-      type: "doc",
-      label: "Migrating Zowe server component from V1 to V2",
-      className: "ToCitemcolor",
-      id:"extend/migrate-extensions",
-    },
-    {
-      type: "doc",
-      label: "Zowe learning resources",
-      className: "ToCitemcolor",
-      id:"getting-started/zowe-resources",
+      type: "category", // doc(default), 'link'(external links), 'ref'(page without without sidebar)
+      label: "Zowe V2",
+      link: {type:"doc", id:"getting-started/zowe-v2-overview"},
+      items: [
+        "getting-started/zowe_v2_faq",
+        "getting-started/zowe-office-hours",
+        {
+          type: "doc",
+          label: "Migrating from Zowe V1 to Zowe V2",
+          className: "ToCitemcolor",
+          id:"extend/migrate-extensions",
+        },
+      ],
     },
+    "getting-started/cli-getting-started",
   ],
-  "setup":[
+  "setup": [
     "user-guide/install-overview",
     {
       type: "category",