4 ms·

Go is the best documented ecosystem I've seen. Since godoc is so widespread, people write doc comments and examples all the time. Every single public project ha

• throwawaaarrgh 4y ago
  Then you clearly have been living with some crap ecosystems. Go is very poorly documented. Basic functionality that is hidden behind environment variables isn't documented at all sometimes. Just figuring out how to compile an app statically took searching through four docs and guessing. The build and install options don't even result in a binary half the time and its not clear why.
  • Beltalowda 4y ago
    The number of flags required to statically compile stuff when using cgo is indeed a bit complex (if you're not using cgo it will always statically compile), partly because interfacing with C is a bit complex. There is an issue to make it easier[1], and doesn't seem too hard to find more information about it[2]. More general: I think I've seen every language described as "badly documented" at this point. Someone new comes to the language, knows what they want to do, gets stuck/frustrated because it's a little bit outside the "mainstream path", and calls it "badly documented". [1]: https://github.com/golang/go/issues/26492 https://github.com/golang/go/issues/26492 [2]: https://duckduckgo.com/?q=go+compile+static https://duckduckgo.com/?q=go+compile+static