Hi Hugo maintainers, I’m a theme contributor who sometimes fixes bugs. I’m excited to hear that the documentation is being restructured using the Diátaxis framework. First, thanks for your ongoing maintenance and responses to the community. Providing example repositories when people ask questions …

A shorter summary of my post: Separating beginner and developer documentation would be a quick and easy win. This alone would greatly reduce cognitive load for most users. The current documentation is detailed enough and doesn’t need more extensive explanations, except for some beginner-orient…

More examples would probably be welcome as well.

[image] ZhenShuo2021: The current alphabetical sorting makes the docs harder to navigate, and the behavior is inconsistent. Most sections use alphabetical order, View the response here Are the documentation sections in the wrong order? .

Thanks for the context! I reviewed the old documentation version , which indeed used a 3-column layout. The main issue was that the left and right columns didn’t scroll properly, which undermined the advantages of the 3-column layout. Otherwise, it offered good navigation and a Diátaxis-style logical…

As someone who is new to Hugo, I agree with your comments. Obviously Hugo was built for programmers, leaving less technical users in the dark. There are some comments elsewhere on this site that say that in that scenario, maybe hugo isn’t for you, but the large selection of themes makes it tempting! …

I actually think Hugo is more suitable for beginners, because it does not require any knowledge of package management, nor an understanding of React (Docusaurus) or Vue (VitePress). It only needs a single binary to run. The difficulty in getting started with Hugo is actually caused more by the docum…

My 2 cents… 1) There is work underway to restructure the documentation. See #2996 . This is not a trivial task. I’ve already spent > 100 uncompensated hours on this, and it’s roughly 30% complete. 2) As part of the above there’s a tutorials section that can be augmented over time, but it will never…

@jmooring I completely understand how massive and complex this task is, and I know you’ve put a lot of effort into Hugo and have already done a great job. My only goal was simply to offer user feedback as a reference. As I said in my last reply, I don’t think complaining is necessary. My intention…

Please don’t feel demotivated. Everyone appreciates all the work that is done developing and supporting hugo.

Thoughts about Hugo's documentation

Topic		Replies	Views
Hacker News is discussing Hugos documentation, pain points Meta	42	5127	December 5, 2024
Documentation restructure and -design Meta	11	4045	May 26, 2016
NEW DOCS SITE! Need feedback! support	44	7567	June 13, 2017
Hugo as a documentation tool feature	45	30828	March 9, 2018
Request: hugo with a 'hello world' example? feature	19	3031	April 5, 2022

Thoughts about Hugo's documentation

Related topics