Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add a v3 migration page #3889

Open
wants to merge 27 commits into
base: master
Choose a base branch
from
Open

Add a v3 migration page #3889

wants to merge 27 commits into from

Conversation

skurnevich
Copy link
Collaborator

Describe your pull request here:

List the file(s) included in this PR:

After creating the PR, follow the instructions in the comments.

Signed-off-by: Sergei Kurnevich <[email protected]>
Copy link

😺 Thank you for creating this PR! To publish your content to Zowe Docs, follow these required steps.

  • Add the label review: doc.
  • Identify your content topic with a label. (Examples: area: apiml, area: cli, area: install and config, etc.)
  • Specify the major Zowe release(s) for your content. (Examples: release: V1, release: V2, release: V3)
    • If adding content that needs to be removed from V3 documentation, add the V3 N/A tag.
  • Select the master branch if your PR updates content that is on the live site. Select docs-staging if your PR updates content for a future release.
  • Notify the Doc Squad about this PR. If you don't know whom should review your content, message the #zowe-doc Slack channel. If you know which Doc Squad writer should approve your content, add that person as a reviewer.

Need help? Contact the Doc Squad in the #zowe-doc Slack channel.

Copy link

⚠️ Looks like something is wrong with the PR description. Remember to add a description and the file(s) included in this PR.

If you have addressed this issue already, refresh this page in your browser to remove this comment.

Copy link

🔍 The review label is missing. Add a review: label so we can determine who needs to approve this PR.

If you have addressed this issue already, refresh this page in your browser to remove this comment.

Copy link

💾 The release label is missing. Add a release: label so your content is published with the correct major Zowe release.

If you have addressed this issue already, refresh this page in your browser to remove this comment.

Copy link

📌 The subject area label is missing. Add an area: label so we know what your content is about.

If you have addressed this issue already, refresh this page in your browser to remove this comment.

Copy link

github-actions bot commented Sep 26, 2024

@github-actions github-actions bot temporarily deployed to pull request September 26, 2024 11:02 Inactive
@github-actions github-actions bot temporarily deployed to pull request September 27, 2024 12:44 Inactive
@github-actions github-actions bot temporarily deployed to pull request September 27, 2024 14:15 Inactive
@skurnevich skurnevich changed the title WIP: Add a v3 migration page Add a v3 migration page Oct 1, 2024
@github-actions github-actions bot temporarily deployed to pull request October 1, 2024 19:00 Inactive
1000TurquoisePogs and others added 2 commits October 1, 2024 21:04
Signed-off-by: 1000TurquoisePogs <[email protected]>
@github-actions github-actions bot temporarily deployed to pull request October 1, 2024 19:21 Inactive
Signed-off-by: Sergei Kurnevich <[email protected]>
@github-actions github-actions bot temporarily deployed to pull request October 1, 2024 19:44 Inactive
1000TurquoisePogs and others added 4 commits October 1, 2024 22:09
Put v2 upgrade instructions at top of v3 migrate guide
Add System Changes section to migrate guide
@github-actions github-actions bot temporarily deployed to pull request October 2, 2024 09:26 Inactive
Signed-off-by: Sergei Kurnevich <[email protected]>
@github-actions github-actions bot temporarily deployed to pull request October 2, 2024 09:54 Inactive
| metrics-service | Removed | 7551 | ZWE1MS | This service has been deprecated and removed. Currently, no replacement is available. The Open Telemetry standard will be implemented later, which will serve as a replacement |
| jobs-api | Removed | 7558 | ZWE1EJ | This component was deprecated in Zowe v2 and is now removed. Ensure that you switch to using equivalent z/OSMF endpoints |
| files-api | Removed | 7559 | ZWE1EF | This component was deprecated in Zowe v2 and is now removed. Ensure that you switch to using equivalent z/OSMF endpoints |
| cloud-gateway | Removed | 7563 | ZWE1CG | The cloud-gateway has replaced the main gateway component in v3 and is now accessible on 7554 as ZWE1AG |
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this detail about cloud-gateway replaces gateway yet takes on the same name and port as gateway is perhaps too much technical information for users - I shared this document with users and they didn't know what it meant.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Then we should just mention that it is removed here

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reverted it to the previous phrase "The cloud-gateway has been removed as a standalone component and merged into the gateway", looks ok?

1000TurquoisePogs and others added 4 commits October 2, 2024 21:39
Signed-off-by: 1000TurquoisePogs <[email protected]>
Signed-off-by: 1000TurquoisePogs <[email protected]>
Add note about v1 for v3 upgrade guide
Signed-off-by: Sergei Kurnevich <[email protected]>
@github-actions github-actions bot temporarily deployed to pull request October 3, 2024 08:41 Inactive
@github-actions github-actions bot temporarily deployed to pull request October 3, 2024 14:32 Inactive
Copy link
Collaborator

@janan07 janan07 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed and edited by doc squad

@github-actions github-actions bot temporarily deployed to pull request October 4, 2024 09:57 Inactive
Copy link
Member

@1000TurquoisePogs 1000TurquoisePogs left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approve and great use of collapsible elements

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants