I wondered why the hell people find that as a surprise here and figured out that is because the syntax for examples is not documented in [1] how to write a doc

I wondered why the hell people find that as a surprise here and figured out that is because the syntax for examples is not documented in [1] how to write a documentation part but instead in [2] "how our testing framework works" - [1] https://go.dev/blog/godoc https://go.dev/blog/godoc - [2] https://pkg.go.dev/testing#hdr-Examples https://pkg.go.dev/testing#hdr-Examples