//open lid


//take sh!t


//close lid

文件打开，数据转储，文件关闭…

/// <summary>
/// The possible outcomes of an update operation (save or delete)
/// </summary>
public enum UpdateResult
{

    /// <summary>
    /// Updated successfully
    /// </summary>
    Success = 0,

    /// <summary>
    /// Updated successfully
    /// </summary>
    Failed = 1
}

我所见过的最好的评论是

/* 
  There is no accounting for pointers 
*/

我参与的一个大型项目在自动构建中使用了StyleCop和FXCop，并使用规则来防止人们检入带有未注释字段、方法、属性等的代码。

有些人对必须添加“获取或设置全名”之类的注释到自记录属性(如FullName)感到非常恼火，以至于他们不得不努力编写一个宏来绕过这些规则。

宏为方法、属性等插入了XML摘要标记，其中一个单一的不显示Unicode字符作为标记内容，这将欺骗构建规则，同时对为了注释而盲目坚持的东西进行轻微打击……

.．.至少直到他们引入了另一条规则来检查注释中的Unicode字符。

这个我在Python 2.5的“twisted”包中找到的(文件是tcp.py在第371行)

# Limit length of buffer to try to send, because some OSes are too
# stupid to do so themselves (ahem windows)
return self.socket.send(buffer(data, 0, self.SEND_LIMIT))

//When I wrote this, only God and I understood what I was doing
//Now, God only knows