Wonderful post by @antirez on best practices for writing comments, as used in the Redis code base.
> “I write code because I have an urgent sense to share and communicate more than anything else. Comments coadiuvate the code, assist it, describe our efforts, and after all I love writing them as much as I love writing code itself.”