openmainframeproject / foundation

Open Mainframe Project foundation level resources, such as the charter, FAQ about the project, and other public assets
https://www.openmainframeproject.org
Creative Commons Attribution 4.0 International
43 stars 21 forks source link

Zowe v2 conformance docs #232

Closed jp669844 closed 2 years ago

jp669844 commented 2 years ago

Signed-off-by: jp669844 jan.prihoda@broadcom.com

jmertic commented 2 years ago

Thanks for this! Can we not do a separate directory and instead apply the changes against the current versions of these docs? It's hard to see what the changes are otherwise. Thanks!

jp669844 commented 2 years ago

We can, however previously we had one table for all components, but now they are split. So this way is applicable only to support criteria.

RASakach commented 2 years ago

@jmertic / @jp669844 : We will need to keep the Zowe V1 Conformance program open / available for extenders who wish to be compatible with Zowe V1 LTS (for the duration of V1 maintenance timeline). If I am understanding the ask -- if we apply the updates against the current version, in essence we are sunsetting the Zowe V1 program. I understand the desire to showcase the changes between V1 & V1. As a means to address this, we did produce a PDF for each program that clearly identifies the changes between the 2 programs. Please see this as an example: https://ibm.ent.box.com/s/rdb7zfkcxzzbiro4idat9o7xd0qig3mt

My proposal: Separate the directories and include the PDFs in the V2 directory that showcases the "diffs" between the V1 and V2 conformance programs.

Note: We will showcase the "diffs" within a given program throughout the lifetime of a given Vx conformance program but we do not want confuse the Vx program with the Vx+1 program. Please let me know if we need to meet to discuss.

jmertic commented 2 years ago

Good points @RASakach and we need to discuss this more. I think it's going to be really complicated if we are running two programs simultaneously.

jp669844 commented 2 years ago

Ok, I will close this PR and open a new one with v1 files updated to v2. The independent files will be in separate PR.

jp669844 commented 2 years ago

Here is the following PR.