Hello!
I still remember a day (a long ago) when after Debug during several days a piece of code, looking for an impossible error ; in an app that we had done with the great Pedro Santos (@pedromsantos), I arrived to a comment similar to this one:
/ / If you’ve arrived here, you probably have a problem.
When this happens and you sleeping only 8 hours in the last 72, this comment makes your day
It must be in the sense of “shared fear” in which you know that someone else suffered along with you this problem, or something like that… . Since that moment I had much more respect for the comments in the code.
Yesterday I came across an entry in stackoverflow basically dedicated to gather the best. I have 3 that look me great.
1: namespace Mobile.Web.Control
2: {
3: /// <summary>
4: /// Class used to work around Richard being a fucking idiot
5: /// </summary>
6: /// <remarks>
7: /// The point of this is to work around his poor design so that paging will
8: /// work on a mobile control. The main problem is the BindCompany() method,
9: /// which he hoped would be able to do everything. I hope he dies.
10: /// </remarks>
11: public abstract class RichardIsAFuckingIdiotControl :
1: //
2: // Dear maintainer:
3: //
4: // Once you are done trying to 'optimize' this routine,
5: // and have realized what a terrible mistake that was,
6: // please increment the following counter as a warning
7: // to the next guy:
8: //
9: // total_hours_wasted_here = 42
10: //
the best one !!!
1: // somedev1 - 6/7/02 Adding temporary tracking of Login screen
2: // somedev2 - 5/22/07 Temporary my ass
How many times I do something ‘temporary’ and last for ever!
Greetings @ La Finca
El Bruno