#comments

Henrik Warne 15 Jun 2021 4 min read

I used to think that I didn’t need comments if I wrote self-documenting code. However, I have realized that I do write comments, and that I find them really useful. To see how many comments I write, and what kind … Continue reading →

programmingcomments

Dave Cheney 29 Mar 2014 1 min read

This post is a follow up to Friday’s post on comments in Go. Keith Rarick and Nate Finch pointed out that I had neglected to include two important practical use cases. Build tags I’ve previously written about how to use // +build tags to perform conditional compilation. In light of the previous post it’s probably […]

goprogrammingbuild constraintscomments

Dave Cheney 28 Mar 2014 2 min read

This is a quick post to discuss the rules of comments in Go. To quickly recap, Go comments come in two forms // everything from the double slash to the end of line is a comment /* everything from the opening slash star, to the closing one is a comment */ As the first form […]

goprogrammingcgocomments