zowe / community

Zowe Community - Sub-projects, Squads, Contribution Guidelines, Meeting Minutes, and more
53 stars 41 forks source link

zowe.org web page re-design #1709

Closed Domenico224 closed 1 year ago

Domenico224 commented 2 years ago

Here is the draft of the redesign from Phoebe (2 options) • Slogan: Combining slogan "Simple, Open, Familiar" in the banner so space got saved and it is more obvious to show on the top. • Annoucement: Saving space of the annoucement, which can be expand and collapsed. • Intro & journey: Brief intro of Zowe first then followed with the journey of Learn-Use-Extend-Contribute. • Zowe components: if we use the layout in option 2, user might be able to see more components in one screen and it could be more friendly for reading. But I understand it costs more development efforts. Option 1 as what it designed now also got its benefits.

Next step show the rendering in a browser

Option 2.jpgOption 1.jpg

DivergentEuropeans commented 2 years ago

Great job to Phoebe on the work and design! Firstly, I wanted to add I'm not a designer. Take my words with a grain of salt, just my thoughts 🙂

The things I love:

Things I think could use some tinkering:

image

Phoebecdy91 commented 2 years ago

@DivergentEuropeans Thanks Leanid for the detailed feedback!! I agree with you that we need to polish the details more for this page. Very good comments and I have marked them down. We can have more further discussion with the whole team and I will iterate the design.

DivergentEuropeans commented 2 years ago

@Phoebecdy91 Np. When in doubt, I'd also go towards minimalism. Part of what I like about our website now, it's a got a minimal feel and high contrast colors, it's what it advertises: simple, easy to read. The redesign is pretty good, but it has a "condensed" feel to it too, we need to take care not to clutter it - good luck, reach out to me please on Slack for any more specific opinions if you want!

balhar-jakub commented 2 years ago

First I prefer the option 1 as it makes it easier to visualize the projects under Zowe.

I do like the announcements change, that's making it less prominent.

I am not even sure the video belongs to the site. I would probably totally remove it and keep it in docs or somewhere else.

RASakach commented 1 year ago

Next steps: Bring proposal to TSC for review / voting for implementation of these zowe.org changes. Assigned to @RASakach

DivergentEuropeans commented 1 year ago

On second and third viewings, agree with @balhar-jakub that option 1 is easier to visualize. Disagree the video should get removed from the site, though I think we should update it instead (understand this is an ANNOYING ask, willing to consider taking this up myself 🙂🙁🙂). I want a video that's no more than 5 min long, I want a brief summary of what Zowe is about, and what the core components bring to the table. More in-depth videos belong in the Docs website

Examples: AWS - https://www.youtube.com/watch?v=a9__D53WsUs Google Cloud - https://www.youtube.com/watch?v=kzKFuHk8ovk

DivergentEuropeans commented 1 year ago

@Phoebecdy91 requested any more comments so I'll message here and let people critique my comments rather than leaving things in DM's - understand not everyone is in favor of minimalism

Other ideas: image

nannanli commented 1 year ago

@Domenico-DAlterio @DivergentEuropeans @balhar-jakub @RASakach @Phoebecdy91 Sam @samanthasusu proposed a new design of the introduction video here: https://github.com/zowe/docs-site/issues/1606#issuecomment-1254760992 Perhaps could be part of this larger revamp effort to record a new shorter version of Zowe overview video focusing on what it is and its value propositions. Then, for intro to each core components, can be a separate series of technical deeper dive videos.

Deck: Zowe overview video redesign draft.pdf Intros: https://user-images.githubusercontent.com/95402892/191709718-1da4bb86-f8dd-4506-8402-c4275a403c52.mp4 https://user-images.githubusercontent.com/95402892/191709701-302008f2-a945-4bab-a167-f0786cfb5e90.mp4

RASakach commented 1 year ago

@DivergentEuropeans @Phoebecdy91 @samanthasusu : Onboarding would like to review the latest proposal for zowe.org changes with you so that we can confirm the latest rev and see if we are all in agreement. Would it be possible to attend this week's Onboarding Scrum on Friday at 8:00am ET? Please advise

RASakach commented 1 year ago

Hey @Domenico-DAlterio I’m using Zenhub in GitHub, click this link to join my workspace and see other features available in GitHub or download the Zenhub extension and sign up with your GitHub account. Posted using Zenhub

Phoebecdy91 commented 1 year ago

@DivergentEuropeans @Phoebecdy91 @samanthasusu : Onboarding would like to review the latest proposal for zowe.org changes with you so that we can confirm the latest rev and see if we are all in agreement. Would it be possible to attend this week's Onboarding Scrum on Friday at 8:00am ET? Please advise

Hi Rosa, thanks for inviting! I will attend this scrum meeting.

samanthasusu commented 1 year ago

@RASakach Thank you Rose! I will join this call.

DivergentEuropeans commented 1 year ago

Ok, will respond to video draft in the video issue thread: https://github.com/zowe/docs-site/issues/1606#issuecomment-1254760992

Phoebecdy91 commented 1 year ago

@RASakach here is the updated design. As we discussed in the scrum meeting:

Comments and feedback are welcome. Let's make it better together. 😄

图片 图片
DivergentEuropeans commented 1 year ago

Awesome @Phoebecdy91 , looking better! 👍 I'd love to see a few more things:

I was originally going to send screenshots with arrows, but I spent a bit of time doing that so I just decided to open up Photoshop and make a rough sketch of what I mean! The below image covers the above points and below it I'll add other things I changed:

design Note: The roughness of the background in the tabs is unintentional, it's there to save time, but it almost makes me wonder if we can do something about it? Do some experimentation, it doesn't look half bad

Let me know your thoughts 🙂

DivergentEuropeans commented 1 year ago

Just got off the onboarding call, having a fourth, fifth look at it now, the video is an area I still feel awkwardness/room for improvement - will think about it more in-detail soon... do you have any thoughts?

RASakach commented 1 year ago

@Phoebecdy91 we had another great discussion on the latest rev for the zowe.org landing page. If you have a chance, review the first 30 minutes of the Onboarding meeting recording here: [(https://zoom.us/rec/share/ew4dlNAcrREi9KVWYZ0ymMNMY1-3K10HEa69ftTqg9ViAVKdH6fXD7s0lFV3xxN5.O1M1Jvz693omr9zy)] and let us know if you have any questions. We agreed with Lenny's suggestions and we had a few more: (1) change the word ANNOUNCEMENT to ANNOUNCEMENTS (2) Change the header UPCOMING AND RECENT EVENTS to RECENT AND UPCOMING EVENTS (to match the order in which the events are presented) (3) Change the color or the surround box (slightly) for any EVENTS that are in the PAST

@DivergentEuropeans (Lenny), funny how I've been overlooking the placement of that video. After taking another look, I agree - awkward for sure. Now that Zowe has some good target market awareness - I feel as though we can move that video behind the LEARN option and place it front-and-center on the page that appears when the website visitor clicks on LEARN. What do you think? If you agree, can you try playing around with that page?

DivergentEuropeans commented 1 year ago

@RASakach I'm alright with keeping the video on the front-page for now in combo with if we can think of a better way to present it - one idea: increase video size, decrease left-side text width by a little, and remove video border for a larger video preview & player. I'd rather have it on the front-page than not, and my opinion will mature depending on the quality of our new video. Final result? Something like this, see if you like it @Phoebecdy91

design2

I presented internally to App Framework squad what our current version of the front-page looks like just to get some fresh eyes into the room, that got us thinking about priorities on what to show on the front itself and @1000TurquoisePogs had some great points that I loved, I want to see them critiqued or integrated into our redesign:

Phoebecdy91 commented 1 year ago

Hi @RASakach @DivergentEuropeans I heard the recording last night! Great discussion! Several updates and feedback here:

image

Tabs:

Introduction of Zowe:

Annoucements:


image

Recent and upcoming events:


image

Survey:

Plus, I am so sorry that I were not able to join our last call and our studio is gonna to have team building this Friday + weekend, I will be out of office. I cannot join our call again! I feel so sorry about it. You guys can discuss it first. Or I can join next week to have detailed discussion or quick iterate with you. THX!

balhar-jakub commented 1 year ago

@DivergentEuropeans I fully agree with when the next release will be. We need to answer this on the front page.

As for the zowe-dev calendar, I don't think we should directly embed it on the front page. If we want it to be useful we should figure out a good way to show the key events coming out of it.

DivergentEuropeans commented 1 year ago

Yes @balhar-jakub something like a "this week's meetings" or some smarts to show the next meetings for the next 4-5 business days

RASakach commented 1 year ago

@Phoebecdy91 Thanks again, for your support in this redesign! Here are the results / requests from today's Onboarding Meeting:

  1. When selected, the TABs should be WHITE, not blue (landing page tab = OVERVIEW) as shown in Lenny's mock-up above
  2. The LOGO at the very top looks great however the words OPEN SIMPLE FAMILIAR should have a period "." after each word as shown in Lenny's mock-up above
  3. Remove "Hi, Welcome to Zowe"; we feel this looks less professional, your hunch was correct.
  4. The Video placement is good, however, the border should be white, not black (see Lenny's mock-up)
  5. in the "Recent and upcoming events" section, it was a great thought to add the bell icon, however we feel that the visitor may associate the bell with the ability to register; can we try to change the color of the titles from blue to gray for past events?
  6. we like your rendition of the question-of-the-month "banner", let's keep that
  7. Although we like the "excited" nature of it, we agreed to eliminate the line "For the OPEN, SIMPLE, FAMILIAR experience, let's get started!" The statement takes up more real-estate on the page and we feel the next header "What would you like to do with Zowe" achieves the same goal.

We discussed additional changes but we don't want to move on those yet because we want to get the next rev out as soon as possible.

Here is the link to the recording if you are interested: https://zoom.us/rec/share/R579zezkPCnWv-46Wgtxjnx_zFW319K4L0EIVw5EZc0Hfks_1_PV1-u-urDKSeHb.rvTR6fJB3NTYXZKL

@samanthasusu: I apologize - I did not realize you were joining us today. We briefly reviewed the video at the very end of our meeting and a few of us agreed to review it again over this coming week and send you recommendations. Thank you for all of your work on this!

samanthasusu commented 1 year ago

@Phoebecdy91 Thanks again, for your support in this redesign! Here are the results / requests from today's Onboarding Meeting:

1. When selected, the TABs should be WHITE, not blue (landing page tab = OVERVIEW) as shown in Lenny's mock-up above

2. The LOGO at the very top looks great however the words OPEN SIMPLE FAMILIAR should have a period "." after each word as shown in Lenny's mock-up above

3. Remove "Hi, Welcome to Zowe"; we feel this looks less professional, your hunch was correct.

4. The Video placement is good, however, the border should be white, not black (see Lenny's mock-up)

5. in the "Recent and upcoming events" section, it was a great thought to add the bell icon, however we feel that the visitor may associate the bell with the ability to register; can we try to change the color of the titles from blue to gray for past events?

6. we like your rendition of the question-of-the-month "banner", let's keep that

7. Although we like the "excited" nature of it, we agreed to eliminate the line "For the OPEN, SIMPLE, FAMILIAR experience, let's get started!"  The statement takes up more real-estate on the page and we feel the next header "What would you like to do with Zowe" achieves the same goal.

We discussed additional changes but we don't want to move on those yet because we want to get the next rev out as soon as possible.

Here is the link to the recording if you are interested: https://zoom.us/rec/share/R579zezkPCnWv-46Wgtxjnx_zFW319K4L0EIVw5EZc0Hfks_1_PV1-u-urDKSeHb.rvTR6fJB3NTYXZKL

@samanthasusu: I apologize - I did not realize you were joining us today. We briefly reviewed the video at the very end of our meeting and a few of us agreed to review it again over this coming week and send you recommendations. Thank you for all of your work on this!

@RASakach Hi Rose, thanks for having this discussion and you don't have to apologize, I was intended to bring this up after the homepage redesign discussion. But I was called to do the covid test so I dropped. I will review all your comments this week and upload the completed demo before this Fri. You could also leave your comments in the storyboard to modify the script. And I will try to make the discussion this Friday.

Phoebecdy91 commented 1 year ago

@RASakach Thanks for the feedback and comments.

We can have discussion later today.

image
RASakach commented 1 year ago

@Phoebecdy91: Thank you for reviewing the latest zowe.org landing page mock-up with us today.

@DivergentEuropeans (Lenny): FYI we are CLOSE to being ready to implement this round of updates, however we'll need "developers" to assist @nannanli (Ashley) and the Doc squad with the implementation. (Phoebe reminded us that the black boarder around the video is something she can't change but I recall Lenny indicating it can be removed programmatically). Assuming Ashley will be prioritizing the webpage development work at some point? How do we want to manage that?

Here's what's left to do: (1) Finalize the new rev of the VIDEO* [this should not hold up implementing our latest changes] (2) Revise the descriptions for EACH of the Zowe projects (in the tiles) such that each tile has roughly the same amount of verbiage (3) Determine where to place the LINK to the current Zowe Roadmap

My proposal for #3 would be to place a sentence at the bottom of this area. (beneath the last paragraph)

"CLICK here for the latest Zowe roadmap"

ZoweRoadmapLinkProposal.PNG

DivergentEuropeans commented 1 year ago

Agreed, this version looks better and better. A few things:

  1. I like the new checkmarks, this works well 👍 @Phoebecdy91
  2. @RASakach @nannanli Ok sure, sounds good. I'd like to find out what we need to help on versus what the Doc squad can implement. Does Doc squad have some web development experience? Can discuss on onboarding call next week's Friday too. Atm, volunteering myself for the challenges ahead
  3. There's a few changes left unaddressed, that were well-liked in my version of the mockup a. The tabs aren't taking up full, centered use of the width b. "build the guture of mainframes" - typo I'm assuming 🙂 c. tab was supposed to be called "Apps" I think? d. The video I can help with. Here's an example: https://docs.zowe.org/stable/getting-started/overview
  4. I like your idea Rose, I think it could be a small hyperlink, see below image. Combination of 3 paragraphs into 2 for summary text, and further removing redundant wording, all intentional for better flow
  5. I still don't see anywhere on the page our version info, added mock idea in below image too

image

Everything else looks pretty slick! I still haven't taken up the action item of embedding our meetings calendar somehow for the "next few meetings" section, however I do want this and will think on it soon if I don't see any suggestions

DivergentEuropeans commented 1 year ago

Ooh, here's another thing! Our vNext page doesn't currently mean "vNext". This tab needs to be renamed to "V1 to V2" right?

balhar-jakub commented 1 year ago

@DivergentEuropeans No, we are going to add the vNext information to it and move the current V1 to V2 away and just mention it on the vNext page.

We agreed on one of the TSC calls around the topic back in the middle of the year, that we will keep the current version for some time before moving to vNext explaining v3

RASakach commented 1 year ago

@DivergentEuropeans, @balhar-jakub @zFernand0 @JillieBeanSim FYI, I have created a document with some verbiage associated with Zowe CLI and Zowe Explorer to be used in the new INTRO VIDEO at at the zowe.org landing page. Please review when possible. @samanthasusu: FYI @Phoebecdy91: FYI

The first section is an attempt to reword the description listed in the TILE for the component on the zowe.org landing page. The second section is an attempt to call out the most important points that should be mentioned in the Zowe INTRO VIDEO.

Here's the LINK: https://ibm.box.com/s/f02rdoafky0b7hqlvxqtpr3435900mv7 (change tracking is on).

RASakach commented 1 year ago

@DivergentEuropeans : We are ready to move forward with this "rev" of the Zowe.org website redesign. We like your suggested mock-up that includes the "next release" and the link to the roadmap, with 2 minor adjustments: (1) Replace "Next release" with "Next planned release" (2) Change the format of the date for the "Next planned release" to yyyyMMMdd (example: 2022DEC12) to eliminate any chance of confusion over which number is the MM and which number is the DD

[For the roadmap, we will be posting it to the website Github repo and will make that link available to you when we have it]

Assuming you can take the lead on implementing these changes? (We realize it is pending your capacity - any idea on an estimated ETA? We do not want to wait for the revised intro video.) TY so much for all of your help with this! FYI: @samanthasusu @Phoebecdy91 @nannanli

DivergentEuropeans commented 1 year ago

Ok, added my App Framework points to the box note. Formatting appears a little wonky with the MSWord Online, but content is there.

Like both your points @RASakach sounds great to me

Assuming you can take the lead on implementing these changes?

I don't mind taking the lead, but I'll say that the time I have to contribute to this will be very spaced out, as we have a roadmap we've committed to already internally. That being said, definitely can work on this slowly over the coming months. And these changes aren't ground-shaking so it shouldn't be too bad. So first I'll ask, are there any web developers who can help me with this in the onboarding squad?

estimated ETA

There's a few things I still don't see in this final version, assuming my latest comment is more or less the final thing: 1) we don't have the meetings calendar embedded 2) we don't see the rest of the pages, just the homepage. If I get time, I'll make a mockup of meetings calendar, but we can move on if needed from the design stage at this point, as that stuff can fall together when development begins - I'm cool with this. I'll give an ETA when I know if I have any help or not. (Very wild guess, as I have worked very little with the Zowe website repo) Assuming no help, and it's just me, say I put in two hours a week, this is probably a 20 hour job including redesigning all pages to fit the new theme, so 10 weeks seems reasonable

balhar-jakub commented 1 year ago

I guess, I am the only other person within the Onboarding squad that is at least somewhat developer. I can try to help but my capacity is very limited.

RASakach commented 1 year ago

Onboarding agreed today that @DivergentEuropeans and @balhar-jakub will take the lead on implementing this re-design work.

ETA: end-of-February

balhar-jakub commented 1 year ago

@DivergentEuropeans @Phoebecdy91 Can any of you help me by providing the background image for the top part of the web page and the images for Question of the month and for the Learn, Use, Create, Contribute?

balhar-jakub commented 1 year ago

The current state of work is visible on this URL: https://deploy-preview-704--condescending-dubinsky-4645a9.netlify.app/

The URL is from PR.

Phoebecdy91 commented 1 year ago

@RASakach @balhar-jakub @DivergentEuropeans Sorry for replying late! It is so glad that we have team to implement this. For the background image, I am using the one in our current webpage. So I don't have the orignal one. And here is the link for Figma file, I think it could be better help you to see some inspect propotities of each component, like the CSS, size, color... And you can also export some image, icons, through this file as well. https://www.figma.com/file/nloQ7TDh59YAKKWCXIKw0C/Zowe.org?node-id=301%3A3012&t=FfRPko5fDSNnkN16-1 I have invited Jakub and Rose to this file but cannot find Lenny's Email address. Feel free to let me know so I can add you to this file. And if this link doesn't work for you, please tell me.

RASakach commented 1 year ago

We are completing the final steps of our phase 1 update: https://github.com/zowe/zowe.github.io/pull/704 ETA Feb 2023

Phoebecdy91 commented 1 year ago

Thanks @balhar-jakub I saw your implementation!! It looks really great!

Just some slight adjustment for the spacing and font size. I am sorry that making this work repeated, but hopefully it can be helpful to make it looks better.

The tile for Learn, Use, Create, Contribute, might need some changes:


As the tile for each component:

And one more quick question, is that possible for us to make it responsive for this page? For example, if the browser is wider, we can show 4 tiles in one row. If narrow, maybe 2 tiles in a row.


❤️Thanks for your implementation work! So sorry that I left too many comments here. Feel free to contact me if we need some prioritization. I am happy work with you for that.

balhar-jakub commented 1 year ago

@Phoebecdy91 I will try to address them within the coming two weeks.

balhar-jakub commented 1 year ago

@Phoebecdy91 All the changes are reflected apart from more responsiveness. The current state is that the projects are responsive in a limited fashion. When the screen is below 750px there is just one column of them.

Making them more responsive would require significant effort. I believe it would be good to have this as a separate issue so it doesn't delay the update to the zowe.org even further.

balhar-jakub commented 1 year ago

The latest PR contains all the changes proposed in this original proposal. As such I am looking for review and then we can merge the changes.

Phoebecdy91 commented 1 year ago

Thanks @balhar-jakub for the implementation! Looks great! And I agree that we can separate it as another issue for the responsive design. And feel free to let me know if anyone who will implement the responsive design, I can provide more details on the tiles for when to be 1 or 2 or 3 or even 4 column regarding to specific width of the page.

And one more quick comment, sorry that I didn't notice that last time. When the announcement section got expanded, the arrow should point up, which means it can be folded.

图片

So when the announcement is folded, the arrow should point down like a dropdown arrow.

图片

Thanks a lot!

balhar-jakub commented 1 year ago

@Phoebecdy91 Please create new issue for responsiveness and assign it to me. I will handle this once the current list of changes is merged.

The change for the icon is now in the PR.

Phoebecdy91 commented 1 year ago

@balhar-jakub Thanks Jakub! I might need some more time to prepare detailed design files for responsive design. I will create the issue once it is ready.

RASakach commented 1 year ago

TSC group reviewed / agreed to publish this iteration of the Website redesign to make it LIVE for the SHARE conference next week.