The new Zowe doc site framework is live! 🎉

[nannanli]

Today we launched our new Zowe doc site framework that will bring you an enhanced content experience. All the improvements are made based on community feedback on the site. We walked through all the issues and feedback over the past 3 years in the Zowe docs-site GitHub repo. After research and design discussion, we decided to migrate the site's static generator from Vuepress to Docusaurus and revamp the overall experience for you to consume Zowe content.

We want to hear your feedback on how you think of the current experience and more importantly how we can make the documentation more engaging and helpful. Share with us any feedback and ideas here in this discussion thread. You can also reach out to the Zowe doc squad in Slack.

Check out a list of new features and improvements as follows. (Special thanks to our contributors @idontknowjs @PlutoZhang for making this happen!)

• Three column layout (nav-topic-mini toc)
  

• Collapsible sidebar (can be changed into two column layout as per need)
  

• Two themes (dark and light)
  

• Zoom-in option for small Doc Images
  

• Estimated reading time for each page
  

• Support reading docs offline

• Social module: "Share" button that allows you to share a topic to social platforms

• Feedback module

  • Rate "Is this topic helpful" - thumbs up and thumbs down. Helpful or not helpful. When not helpful, you can get a link to create a GitHub issue.
  • "Open doc issue" option for each page that directs users to the doc site repo with associated topic URL and background information in the issue automatically.
  • Better visible "Edit this topic" link that directs users to the source file for each topic

• Can print PDF (download the complete doc into PDF)

• Similar look and feel with zowe.org (includes footer)

• Enhanced doc site UX with improved home page design
  

[mv-nbfc]

Love the Zowe documentation site. I managed to get Zowe up and running for most functions in a days time while still attending meetings - well done.