First project, 2 days of trying to make it work, so far so good, but fighting it every step of the way because it behaves like a black box. I thought I’d post this as feedback while I am at it.
The docs are good, but a lot of the details is either missing or is scattered across different sections. E.g. config
logFile. I set
log = true+
hugo server -v- no log. I added 'logFile = “log.txt”`, still nothing. The same with an absolute path, still no log. Where does it write it? What’s missing?
The logic of the site building is a black box. Why did it ignore the content I’ve just added? Why is it using a wrong layout? I have to spend hours makinging seemingly random changes to figure it out.
What would be good is to have a detailed log where it reasons about the decision tree. E.g. looking at dir X, found index.md, content type …, layout …, ignoring file …, and so on.
Some core types are obscure. e.g. nopPage. A quick lookup tells me it’s a Page that does nothing. Not very helpful because I have no idea WHY it got this nop when I expected some page there.
I’d love to contribute, but Go is not in my stack. Happy to chip in with the docs if you think this kind of PRs will be considered by maintainers.