I'm pleased to announce that the Kubernetes website now features the Docsy Hugo theme. The Docsy theme improves the site's organization and navigability, and opens a path to improved API references. After over 4 years with few meaningful UX improvements, Docsy implements some best practices for technical content.
Author: Zach Corleissen, Cloud Native Computing Foundation
Editor's note: Zach is one of the chairs for the Kubernetes documentation special interest group (SIG Docs).
The Docsy theme improves the site's organization and navigability, and opens a path to improved API references. After over 4 years with few meaningful UX improvements, Docsy implements some best practices for technical content. The theme makes the Kubernetes site easier to read and makes individual pages easier to navigate. It gives the site a much-needed facelift.
For example: adding a right-hand rail for navigating topics on the page. No more scrolling up to navigate!
The theme opens a path for future improvements to the website. The Docsy functionality I'm most excited about is the theme's
[swaggerui](https://www.docsy.dev/docs/adding-content/shortcodes/#swaggerui) shortcode, which provides native support for generating API references from an OpenAPI spec. The CNCF is partnering with Google Season of Docs (GSoD) for staffing to make better API references a reality in Q4 this year. We're hopeful to be chosen, and we're looking forward to Google's list of announced projects on August 16th. Better API references have been a personal goal since I first started working with SIG Docs in 2017. It's exciting to see the goal within reach.
One of SIG Docs' tech leads, Karen Bradshaw did a lot of heavy lifting to fix a wide range of site compatibility issues, including a fix to the last of our legacy pieces when we migrated from Jekyll to Hugo in 2018. Our other tech leads, Tim Bannister and Taylor Dolezal provided extensive reviews.
The CNCF contracted with Gearbox in Victoria, BC to apply the theme to the site. Thanks to Aidan, Troy, and the rest of the team for all their work!
UX Design is the process of enhancing user satisfaction with a product by improving the usability, accessibility, and pleasure provided in the interaction between the user and the product
Do you need UI/UX Designers for hire? **[Hire Dedicated UI/UX Developer](https://hourlydeveloper.io/hire-dedicated-ui-ux-developer/ "Hire Dedicated UI/UX Developer")** from **[HourlyDeveloper.io](https://hourlydeveloper.io/...
Forrester Research’s report, “Rich Internet Application Errors to Avoid,” shows that 70% of projects fail due to lack of user acceptance.
In Practical Criticism, I. A. Richards compared tone to social manners and defined it as the reflection in a discourse of the author’s attitude towards his audience.
When it comes to user convenience, understanding consumer habits is as important as the market your app operates in. The ability to combine simple gestures with user-friendly interface results in a solution that appears simple and comprehensive. Mirroring of the physical actions into digital ones is one of the ways to do it.