better to describe what it does rather than why it is here the  why  can be found in the commit message git blame  it does not hurt too much to include it here although it may suffer from comment rot  