Should be used with reason but include enough information so that a reader can get a first grasp of what a part of code is supposed to do.