Programmers Stack Exchange is a question and answer site for professional programmers interested in conceptual questions about software development. Join them; it only takes a minute:

Sign up
Here's how it works:
  1. Anybody can ask a question
  2. Anybody can answer
  3. The best answers are voted up and rise to the top

I am going to fork an open source project. Would you recommend to create a new changelog file or to update the original one? Would it be reasonable to increment its version number or would it be better to reset it?

share|improve this question
up vote 3 down vote accepted

There's a lot to be said for resetting the version number to major+1.0.0, although some folks prefer 1.0.0 (which seems seriously wrong). Most importantly, it says "this is based on the major.*something*.somethingelse level of the forked package, but from here forward it's different". For example, Secure Sockets Layer (SSL) had 1.0 and 2.0, and the replacement Transport Layer Security (TLS) started at 3.0.

And yes, reset the changelog.

share|improve this answer

If by fork, you mean start an upstream incompatible project, then I'd recommend resetting the version number and simply referencing the old changelog on the first commit for your changes.

(Github and other dvcs services have added new meaning to "fork").

share|improve this answer

Your Answer


By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.