From e6a277647af516359badf454c0ca076b8b727411 Mon Sep 17 00:00:00 2001 From: anaxceron Date: Wed, 2 Oct 2024 15:36:50 -0400 Subject: [PATCH 1/5] relocating items in what's new section; editing for style, consistency Signed-off-by: anaxceron --- docs/appendix/zowe-glossary.md | 2 +- docs/getting-started/zowe-office-hours.md | 2 +- docs/getting-started/zowe-resources.md | 27 +++---- docs/getting-started/zowe-v2-overview.md | 27 +++++++ docs/getting-started/zowe_faq.md | 2 +- docs/getting-started/zowe_v2_faq.md | 2 +- .../zowe-v3-frequently-asked-questions.md | 2 +- sidebars.js | 79 ++++++------------- 8 files changed, 68 insertions(+), 75 deletions(-) create mode 100644 docs/getting-started/zowe-v2-overview.md diff --git a/docs/appendix/zowe-glossary.md b/docs/appendix/zowe-glossary.md index 1c092761f4..234080b73b 100644 --- a/docs/appendix/zowe-glossary.md +++ b/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. diff --git a/docs/getting-started/zowe-office-hours.md b/docs/getting-started/zowe-office-hours.md index 50d1915835..70fd0b24f0 100644 --- a/docs/getting-started/zowe-office-hours.md +++ b/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. diff --git a/docs/getting-started/zowe-resources.md b/docs/getting-started/zowe-resources.md index 79d47fcd41..a6ab87911c 100644 --- a/docs/getting-started/zowe-resources.md +++ b/docs/getting-started/zowe-resources.md @@ -13,15 +13,14 @@ Want to contribute a blog? Details for how to contribute to the [Zowe blogs on M -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) @@ -29,26 +28,26 @@ Find out what's happening with Zowe in the Zowe Quarterly Update Webinar Series. - [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) @@ -56,20 +55,18 @@ The [OMP Youtube channel](https://www.youtube.com/channel/UC-WTXQQtz2m5iTflJLK59 ## 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. diff --git a/docs/getting-started/zowe-v2-overview.md b/docs/getting-started/zowe-v2-overview.md new file mode 100644 index 0000000000..e396bfd8e3 --- /dev/null +++ b/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) \ No newline at end of file diff --git a/docs/getting-started/zowe_faq.md b/docs/getting-started/zowe_faq.md index 476000dcf3..b881f4576c 100644 --- a/docs/getting-started/zowe_faq.md +++ b/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™. diff --git a/docs/getting-started/zowe_v2_faq.md b/docs/getting-started/zowe_v2_faq.md index 5d498f42e1..938d31523d 100644 --- a/docs/getting-started/zowe_v2_faq.md +++ b/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? diff --git a/docs/whats-new/zowe-v3-frequently-asked-questions.md b/docs/whats-new/zowe-v3-frequently-asked-questions.md index 0247009e96..f48e0b7966 100644 --- a/docs/whats-new/zowe-v3-frequently-asked-questions.md +++ b/docs/whats-new/zowe-v3-frequently-asked-questions.md @@ -1,4 +1,4 @@ -# Zowe V3 Frequently Asked Questions +# Zowe V3 FAQs ## General questions diff --git a/sidebars.js b/sidebars.js index 4d7581ff14..c87ff43b92 100644 --- a/sidebars.js +++ b/sidebars.js @@ -9,37 +9,6 @@ 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", ], }, ], @@ -74,37 +43,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 Zowe server component from V1 to V2", + className: "ToCitemcolor", + id:"extend/migrate-extensions", + }, + ], }, + "getting-started/cli-getting-started", ], - "setup":[ + "setup": [ "user-guide/install-overview", { type: "category", From e3b73e82409e502188e0cd76312013c4d6fc8b05 Mon Sep 17 00:00:00 2001 From: anaxceron Date: Thu, 3 Oct 2024 09:20:55 -0400 Subject: [PATCH 2/5] adding back v2 release notes; link to V3 FAQs Signed-off-by: anaxceron --- docs/whats-new/zowe-announcements.md | 2 ++ sidebars.js | 29 ++++++++++++++++++++++++++++ 2 files changed, 31 insertions(+) diff --git a/docs/whats-new/zowe-announcements.md b/docs/whats-new/zowe-announcements.md index b1396ceece..7de70d49f6 100644 --- a/docs/whats-new/zowe-announcements.md +++ b/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. diff --git a/sidebars.js b/sidebars.js index c87ff43b92..fc47d2ebc9 100644 --- a/sidebars.js +++ b/sidebars.js @@ -9,6 +9,35 @@ module.exports = { link: {type:"doc", id:"whats-new/release-notes/release-notes-overview"}, items: [ "whats-new/release-notes/v3_0_0", + { + 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", + ], + }, ], }, ], From b4bf4608c4e1407b06791608999a5f7e66d3cbea Mon Sep 17 00:00:00 2001 From: Andrew Jandacek Date: Thu, 3 Oct 2024 16:24:58 +0200 Subject: [PATCH 3/5] update language to present tense for V3 FAQs Signed-off-by: Andrew Jandacek --- .../zowe-v3-frequently-asked-questions.md | 22 +++++-------------- 1 file changed, 6 insertions(+), 16 deletions(-) diff --git a/docs/whats-new/zowe-v3-frequently-asked-questions.md b/docs/whats-new/zowe-v3-frequently-asked-questions.md index f48e0b7966..1dc04341de 100644 --- a/docs/whats-new/zowe-v3-frequently-asked-questions.md +++ b/docs/whats-new/zowe-v3-frequently-asked-questions.md @@ -1,26 +1,16 @@ # Zowe V3 FAQs -## 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. - ## 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? @@ -28,7 +18,7 @@ 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? From f37c00531d1c674495e973542f9dab2d7a1b3c0b Mon Sep 17 00:00:00 2001 From: Andrew Jandacek Date: Thu, 3 Oct 2024 16:27:33 +0200 Subject: [PATCH 4/5] name change for migrating v1 to v2 file Signed-off-by: Andrew Jandacek --- docs/extend/migrate-extensions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/extend/migrate-extensions.md b/docs/extend/migrate-extensions.md index 65c71d362c..7d3876ff85 100644 --- a/docs/extend/migrate-extensions.md +++ b/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. From 680b3b95bedc6c361578916354866e1fee2942c8 Mon Sep 17 00:00:00 2001 From: Andrew Jandacek Date: Thu, 3 Oct 2024 16:35:23 +0200 Subject: [PATCH 5/5] fix title in sidebar Signed-off-by: Andrew Jandacek --- sidebars.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sidebars.js b/sidebars.js index fc47d2ebc9..53b3cba405 100644 --- a/sidebars.js +++ b/sidebars.js @@ -94,7 +94,7 @@ module.exports = { "getting-started/zowe-office-hours", { type: "doc", - label: "Migrating Zowe server component from V1 to V2", + label: "Migrating from Zowe V1 to Zowe V2", className: "ToCitemcolor", id:"extend/migrate-extensions", },