Skip to content

Commit

Permalink
Update the Conformance Support Information
Browse files Browse the repository at this point in the history
Signed-off-by: Jakub Balhar <[email protected]>
  • Loading branch information
balhar-jakub committed Dec 22, 2023
1 parent 90d540e commit 0ad8c93
Show file tree
Hide file tree
Showing 3 changed files with 24 additions and 21 deletions.
3 changes: 2 additions & 1 deletion _data/vnext_announcements.yml
Original file line number Diff line number Diff line change
@@ -1 +1,2 @@
- announcement: Zowe v3 is going GA on 2024/03/28
- announcement: Zowe v3 is going GA on 2024/03/28
- announcement: Learn more about Zowe Extensions V3 Compatibility, Conformance, and Availability Statement on Downloads page
2 changes: 2 additions & 0 deletions _data/vnext_changes.yml
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@
- Datasets API is archived
- Jobs API is archived
- Metrics service is archived
- IMS API is archived
- Java 17 is required for API Mediation Layer to run
- z/OSMF in version V2R5 (preferred) or V2R3, V2R4 with APAR PH12143 applied
- Statically onboarded services needs to do it via modifying the zowe.yaml and adding a directory outside of the zowe to read the files from
Expand Down Expand Up @@ -42,6 +43,7 @@
- Remove V1 profile support
- Change authentication order of preference
- Remove deprecated items - [CLI](https://github.com/zowe/zowe-cli/issues/1694) and [Imperative](https://github.com/zowe/imperative/issues/970)
- IMS CLI extension is archived
**Important updates**
Expand Down
40 changes: 20 additions & 20 deletions download.md
Original file line number Diff line number Diff line change
Expand Up @@ -724,44 +724,44 @@
</section>

<section class="whitebackground" id="compatibility-extensions">
<h1>Zowe Extensions V2 (previously vNext ) Compatibility, Conformance, and Availability Statement</h1>
<h1>Zowe Extensions V3 Compatibility, Conformance, and Availability Statement</h1>
<b>General</b><br />
<i>Backward Compatibility</i><br />
<p>Zowe v1 conformant extensions / plug-ins <b>are not guaranteed</b> to be compatible with Zowe v2 and therefore may
<p>Zowe v2 conformant extensions / plug-ins <b>are not guaranteed</b> to be compatible with Zowe v3 and therefore may
not be operable. In general, plug-ins/extensions which leverage v2 APIs that have known “breaking changes” are at
<i>high risk</i> of incompatibility and unpredictable results. </p>
<p><u>Recommendation:</u> ALL v1 extenders test with the Zowe v2, identify any issues, and disclose results to
<p><u>Recommendation:</u> ALL v2 extenders test with the Zowe v3, identify any issues, and disclose results to
consumers to clearly indicate backward compatibility status in the extension documentation. If unable to test,
clearly document as such.</p>
<br />
<i>Forward Compatibility</i><br />
<p>Zowe v2 conformant (planning to earn conformance) extensions / plug-ins <b>are not guaranteed</b> to be compatible
with Zowe v1 LTS. In general, plug-ins / extensions with no known dependency on any newly introduced Zowe v2
<p>Zowe v3 conformant (planning to earn conformance) extensions / plug-ins <b>are not guaranteed</b> to be compatible
with Zowe v2 LTS. In general, plug-ins / extensions with no known dependency on any newly introduced Zowe v3
functions are at <i>minimum risk</i>.</p>
<p><u>Recommendation:</u> All v2 extenders test with Zowe v1 LTS, identify any issues, and disclose results to
<p><u>Recommendation:</u> All v3 extenders test with Zowe v2 LTS, identify any issues, and disclose results to
consumers to clearly indicate forward compatibility status in the extension documentation. If unable to test,
clearly document as such.</p>
<br />
<i>Conformance Compatibility</i><br />
<p>Zowe v1 conformant extensions / plug-ins are likely to require changes to meet Zowe v2 conformance criteria. All
extensions (regardless of v1 conformance status) must apply for v2 conformance and satisfy all required v2 testing
<p>Zowe v2 conformant extensions / plug-ins are likely to require changes to meet Zowe v3 conformance criteria. All
extensions (regardless of v2 conformance status) must apply for v3 conformance and satisfy all required v3 testing
criteria.</p>
<p><u>Recommendation:</u> All extenders interested in earning v2 conformance review the v2 conformance criteria,
determine if technical changes are necessary, make appropriate modifications and prepare to apply for v2 conformance
prior to v2 LTS publication.</p>
<b>Zowe v2 Availability to Extenders</b><br />
<p><u>Recommendation:</u> All extenders interested in earning v3 conformance review the v3 conformance criteria,
determine if technical changes are necessary, make appropriate modifications and prepare to apply for v3 conformance
prior to v3 LTS publication.</p>
<b>Zowe v3 Availability to Extenders</b><br />
<i>Early Access Software </i><br />
<p>Several pre-GA releases of Zowe v2 will be made available to Zowe extenders and the general public prior* to the
actual Zowe v2 GA release delivery to allow extenders time to perform Zowe v2 testing with their extensions and
disclose their compatibility status. (*dates to-be-determined)</p>
<p>Several pre-GA releases of Zowe v3 will be made available to Zowe extenders and the general public prior* to the
actual Zowe v3 GA release delivery to allow extenders time to perform Zowe v3 testing with their extensions and
disclose their compatibility status. (The PAX and SMP/E builds are available since Dec 2023)</p>
<i>Early Access Conformance Criteria</i><br />
<p>The Zowe v2 conformance criteria for all extensions/plugins participating in the conformance program will be made
available to all Zowe v1 conformant extenders prior* to the Zowe v2 GA release to give extenders time to adapt to
<p>The Zowe v3 conformance criteria for all extensions/plugins participating in the conformance program will be made
available to all Zowe v2 conformant extenders prior* to the Zowe v3 GA release to give extenders time to adapt to
applicable changes. (*dates to-be-determined) Note: See Zowe Support Provider conformance section below for details
on v2 Support Provider conformance.</p>
on v3 Support Provider conformance.</p>
<b>More Information</b>
<p>Visit the Zowe v2 release page at <a href="https://zowe.org/vNext.html">https://zowe.org/vNext.html</a> for
comprehensive information related to the V2 release.</p>
<p>Visit the Zowe v3 release page at <a href="https://zowe.org/vNext.html">https://zowe.org/vNext.html</a> for
comprehensive information related to the V3 release.</p>

</section>

Expand Down

0 comments on commit 0ad8c93

Please sign in to comment.