You make a few noteworthy observations.
Allow me to quote from here - the author is a fan of SSGs and Hugo
In one of my past Work Lives, I wrote user manuals for fax machines. (Obviously, this was a long time ago.) Our team prided ourselves on “writing for Grandma,” as we put it then, because our products were bought by people of all ages and experience levels. Thus, I am acutely aware how far short SSGs’ docs fall when it comes to being understandable by people outside the narrow circle of their own community, and sometimes even some within it.
At some point, the SSG folks will have to decide whether they do indeed want to maintain their role as Merlins rather than making SSGs accessible to ordinary users, particularly in corporate life. I mean, WordPress is a God-awful, performance-eating, security-defying thing—but at least your average Joe or Jane, and most notably your average Joe or Jane in corporate settings that aren’t going to hire dev help for them, can use it. Try that with any SSG.
and from a footnote here
Of course, you should also check the official Hugo documentation, but be forewarned that it’s clearly intended for a more technically oriented audience
FWIW, and with the greatest respect to those who have replied above, I find their comments mostly reflecting the issue at hand: coders/devs talking amongst themselves where jargon is a regular pattern of speech. It’s like I’m brosing Hacker News comments. The aforementioned ELI5 principle seems an almost foreign concept, something to be eschewed for reasons that escape me.
I’ll reiterate ad nauseam: my OP isn’t intended to bash Hugo or disrespect its devs and the general community. Far from it. I want Hugo to prosper and reach a wider audience. IMHO it’s necessary to reflect on an issue that hasn’t been addressed with some urgency during its rise to prominence: make Hugo better usable for Joe User. For the rest of us, so to speak.