Re: Using VC for change descriptions

[Richard Stallman]

[[[ To any NSA and FBI agents reading my email: please consider    ]]]
[[[ whether defending the US Constitution against all enemies,     ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]

  > Don't we also need a way to associate a description with each of those
  > changes?  I don't see identifying entities as a difficult problem for
  > someone who has time to do it, but it doesn't eliminate the need for
  > hand-writing descriptions of the changes.

If the overall explanation in the ChangeLog entry is thorough, it
might give that information well enough.  But it is hard for me to be
sure.

Perhaps it would be good to do an experiment.

Someone who advocates not itemizing entities in the history
could take the change log for some period of time and rewrite it
to say what he believes we should include: a more extensive explanation
of the change overall.

Then we can try understanding changes in two ways: based on change
logs as we write them, and based on that rewritten history, and
see whether it makes a big difference.

-- 
Dr Richard Stallman
President, Free Software Foundation (https://gnu.org, https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)
Skype: No way! See https://stallman.org/skype.html.