A Better Docs With Docsy

A Better Docs With Docsy

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).

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. 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.

Thanks also to Björn-Erik Pedersen, who provided invaluable advice about how to navigate a Hugo upgrade beyond version 0.60.0.

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

Bootstrap 5 Complete Course with Examples

Bootstrap 5 Tutorial - Bootstrap 5 Crash Course for Beginners

Nest.JS Tutorial for Beginners

Hello Vue 3: A First Look at Vue 3 and the Composition API

Building a simple Applications with Vue 3

Deno Crash Course: Explore Deno and Create a full REST API with Deno

How to Build a Real-time Chat App with Deno and WebSockets

Convert HTML to Markdown Online

HTML entity encoder decoder Online

An Introduction to UX Design

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

Hire Dedicated UI/UX Developer

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/...

Does UX makes organizations smarter?

Forrester Research’s report, “Rich Internet Application Errors to Avoid,” shows that 70% of projects fail due to lack of user acceptance.

Tone of Voice and UX Design

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.

The Tips and Tricks for Building UX in Fintech

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.