hugo gets updated very often when I update my operating system. I expect my site to keep working if I don’t touch it, but it’s not the case. It would be very nice if there was a breaking changes page somewhere in gohugo.io so I don’t need to read thousands of changes in case something breaks some day.
The Release Notes mentions “if you have lots of inline HTML…”. I don’t, but my site is still broken because the shortcodes are HTML, so they all disappeared. I just wanted to change a few words in my site but it turned out to be much longer.
I noticed the shortcodes were gone, so I went to the documentation (I can’t read the last 20 release notes) to see if the syntax had changed, where I see that you can now use either {{< and >}} and {{% and %}}, or is it />}} and /%}}? both are shown there… and index .Params 0 is now .Get 0? But both ways are still shown without mentioning what is the old and the new way. Tried them all out… then finally noticed the raw HTML omitted messages…
I let someone else parse and convert this into issues if needed 
Happy holidays!