我前几天刚检查过这个…

/// <STERNLY-WORDED-WARNING>
/// Pay attention to this or I will hunt you down.
/// ...
/// </STERNLY-WORDED-WARNING>

(“……”== "专有的东西，我不能发布")。我只是喜欢我的措辞严厉的警告元素。

// TODO: Delete

// this comment included for the benefit of anyone grepping for swearwords: shit.

为什么你不应该将你的软件开发外包的一个经典案例:

public class Contact
{
    //...    

    /// <summary>
    /// Gets or sets the name of the first.
    /// </summary>
    /// <value>The name of the first.</value>
    public string FirstName
    {
        get { return _firstName; }
        set { _firstName = value; }
    }
}

在大学的一次家庭作业中，一位老师特别坚决地要求我们注释代码:

//I wonder if she actually reads these.

当作业被返回时，在注释“是的，我愿意”旁边用红笔写着

// This condition can't happen. Call the police or something.