https://hugodocs.info Overview This project started in reaction to this Discourse thread from November 2016 This is not a theme; this is a complete overhaul of the Hugo docs, particularly the content component. I am looking for feedback on content and not design. The awesome @budparr has already v…

tl;dr; To both your questions, @sethm , I really don’t know, but I’m open to suggestions :smile: [image] sethm: What is the best way to figure out which errors are most common? That is a very good question. Unless you have a feedback mechanism built into the tool itself that sends errors t…

I come from a communication/marketing background and lack some development skills, so please take what follows with that in mind. The focus is on content and not how the docs are structured. First, the challenges. When reading the documentation it was fairly easy to find what I needed to port a …

@brunoamaral Thanks for the feedback! Just to clarify, are you talking about the current docs ( gohugo.io ), the concept site ( hugodocs.info ), or both? For the record, I consider myself a publisher/content strategist first and a developer (maybe) second, so your feedback is exactly what I’m looking …

It applies to both. I only took a quick read through the new docs and it appeared to have a similar text and changes in structure. The functions quick reference does help, and points towards a problem that would rise from using a glossary. There needs to be a clear distinction between what are con…

[image] rdwatters: Hugo is changing (read: improving) constantly, and the old tutorials section was, quite literally, outdated in every single page. Instead, I think it’s best to structure the new version as logically as possible, promote cross-linking, be fastidious about documenting undocument…

@justrjlewis This is also great feedback and thank you! I think there is definitely room for improvement in the forums that will hopefully come in the future, but for right now I’m just trying to focus on what should and shouldn’t be in the documentation. @budparr is currently working on what might…

[image] rdwatters: What was the most difficult concept to grok when you first started learning Hugo? Variable scoping. I was planning to write an explainer as soon as I get my head around it myself. EDIT: is variable scoping behaviour due to the design of Hugo, or is it due to the Go html/te…

Beautiful design; much nicer than the old site. Here’s my beginner problem: I have a site working using the hugo-material-docs theme. Site: www.WinterTechForum.com Github Repo: https://github.com/BruceEckel/WinterTechForum I’ve tried both the old and new documentation, and I’ve been unable to fi…

Hi, small tiny request: May there be a scrollbar next to the page? The long document pages can be easily scrolled to the desired location using a scrollbar. Currently there are no scrollbars and it’s a bit of a hassle to scroll with mouse and with keyboard requires many keypresses.

Do you still take docs feedback, @rdwatters ? If so, I think the docs will benefit from clarifying what “page” means, since it doesn’t mean “HTML page” or “rendered webpage”. For instance, .Site.RegularPages is, according to the docs a “regular page collection”, but I learned it can also contain n…

NEW DOCS SITE! Need feedback!

support

totoff June 1, 2017, 7:50pm 43

like the new docs site pretty much. has become my standard docs site. great work!

How does hugo relate a .md file to a html layout file?

Topic		Replies	Views
Request: hugo with a 'hello world' example? feature	19	2995	April 5, 2022
Comprehensive hugo tutorial for beginners? support	55	29293	February 23, 2020
Hacker News is discussing Hugos documentation, pain points Meta	42	5028	December 5, 2024
Hugo as a documentation tool feature	45	30729	March 9, 2018
Documentation restructure and -design Meta	11	4026	May 26, 2016

NEW DOCS SITE! Need feedback!

Related topics