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

Inconsistent download pages #855

Open
1000TurquoisePogs opened this issue Aug 12, 2022 · 4 comments
Open

Inconsistent download pages #855

1000TurquoisePogs opened this issue Aug 12, 2022 · 4 comments
Assignees

Comments

@1000TurquoisePogs
Copy link
Member

When you download something on https://www.zowe.org/download.html
The action that happens after the download varies by which thing you download.

Some downloads redirect the webpage to a docs.zowe.org page which explains how to install them.
Others redirect the webpage to a zowe.org page which explains how to verify the authenticity of the download.

But, we should do both, always!
https://zowe.jfrog.io/artifactory/list/libs-release-local/org/zowe/2.2.0/ contains the hash needed to verify any of our zowe downloads.
But only the pax option sends you to this page https://www.zowe.org/post_download.html?version=2.2.0 explaining how to get the hash file, and how to use it.
The page seems specific to .pax, but the instructions can be done on any of the download types!
And, if you end up at docs.zowe.org instead of this page, docs.zowe.org doesnt have these instructions so you can't learn how to verify a download with the other download types

I think the website should be changed to either

  • have these instructions on each installation guide
    or
  • have this page on each download type, prior to going to the documentation.
@samanthasusu samanthasusu self-assigned this Apr 6, 2023
@1000TurquoisePogs
Copy link
Member Author

1000TurquoisePogs commented Jul 25, 2023

This was discussed on the TSC more recently, and we came to a conclusion about how we'd like to fix this.
As far as I remember, we said: Each download type should have a page about hash verification just like the convenience build does today. The only difference is that each hash page should be customized to whichever download you just downloaded, because that page has a link to the documentation on it, and you want to point people to your preferred documentation page, according to which thing they just downloaded.

The fix needs to be written here https://github.com/zowe/zowe.github.io
When a user clicks a download here https://github.com/zowe/zowe.github.io/blob/master/download.md
It should take them to the legal page here https://github.com/zowe/zowe.github.io/blob/master/legal.md
And then finally the post-download page here https://github.com/zowe/zowe.github.io/blob/master/post_download.md

This currently happens for the convenience build download.
We want it to happen for all downloads, which means the "legal" page currently seen on each download needs to have its target URL for "I agree" changed to the "post_download" page and have that page have slightly different content & links depending on which download you just did (how? by duplicating the page? by templating?)

@1000TurquoisePogs
Copy link
Member Author

Note: the verification file referenced in the post_download page already exists for all the download types, you can find it at https://zowe.jfrog.io/zowe/list/libs-release-local/org/zowe/2.9.0/, substituting version & file.

@balhar-jakub
Copy link
Member

It's been added for client side and the issue belongs to https://github.com/zowe/zowe.github.io

@balhar-jakub balhar-jakub transferred this issue from zowe/docs-site Aug 14, 2023
@lparadkar-rocket
Copy link

Thanks @balhar-jakub for working on this.

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

No branches or pull requests

4 participants