[arendtio]

I never tried Gatsby, but I tried Hugo. I like Go, so I searched for a Hugo-template I liked and build some documentation for my project. Then I took a break from the project and when I wanted to update the documentation a few months later (minor changes), I spend about 2 days just bringing my content in sync with the updated template. What a horrible experience.

Maybe I was doing something wrong or the template author, but actually I am thinking about my best options currently, because I am 100% sure, I don't want to go through that mess again. Even building plain HTML pages by hand would have been a lot easier for me than finding out why the updated template didn't compile anymore.

[todotask]

What was the actual issue it did not compile and what was resolve?

[arendtio]

If I remember correctly, Hugo wasn't able to process the template-content combination when I tried starting it after a few months of not using it (Hugo had been updated meanwhile). So I updated the template which didn't solve the issue. Then I tried to find out what changed and it wasn't just a few lines of code, but more fundamental things.

In the end, I just took a completely fresh version of the template and rebuild the documentation by copy and pasting the relevant parts.

For context: Initially I build the documentation in November 2018 and the update happened in April 2020.

[sofixa]

You could have just used the same Hugo version as initially.

It's a moving project and yeah, there have been a lot of changes, with some breaking ones (usually for good reason).

[todotask]

For what we know 0.x version is not backward compatible as with many other projects, that can break many things. Let wait for a bright release.