Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create CHANGELOG.md #685

Closed
wants to merge 1 commit into from
Closed

Create CHANGELOG.md #685

wants to merge 1 commit into from

Conversation

ZeeCoder
Copy link

I've been ignoring updates to this project, as there's no easy way to tell what changed in any given version.
To help myself and potentially others, I propose adding the following changelog to the project.

Some advise in terms of maintaining the changelog:

  • All meaningful features / patches should make their way under the [Unreleased] section, so that once it's time to release it's easy to move everything under whatever release version you've chosen.
  • When you choose a release version, pay attention to the changes you have under the unreleased section: if there's anything "Added", then it's a minor version bump. If there are breaking changes, it's major, and otherwise patch is sufficient.
  • Make sure PRs include changes under [Unreleased]. This again will make your job easier, and also signals to people looking at the master branch's changelog that those features are about to be released.

Hope you find this useful. 👍

Added changelog with changes since 1.27.0-beta.
@Mottie
Copy link
Owner

Mottie commented Jul 24, 2018

Hi @ZeeCoder!

I do keep a change log in the wiki pages. Would that suffice, or would it be better to keep it in the repo?

@Mottie
Copy link
Owner

Mottie commented Jul 24, 2018

And in the main readme, I show the 3 most recent changes.

@ZeeCoder
Copy link
Author

Yes that wiki changelog is excactly what I would've wanted!
I think it would be better to keep it in the file though, or maybe just a link to the wiki? Not sure.
It's kind of standard to keep a changelog file, so people will definitely look there and are not guaranteed to find it on the wiki.
Or in the main readme either, it wouldn't have occurred to me that you have notes at the bottom. 😅

@Mottie
Copy link
Owner

Mottie commented Jul 24, 2018

Yeah, I didn't add a CHANGELOG.md because I've never liked all the clutter in the root folder. I wish I could move all the dot files and stuff into a sub-folder.

I guess I could add a CHANGELOG.md file that points to the wiki page, to save me the trouble of moving stuff around.

@ZeeCoder
Copy link
Author

Yeah, that's perfectly fine with me 👍

@ZeeCoder ZeeCoder closed this Jul 24, 2018
Mottie added a commit that referenced this pull request Jul 24, 2018
@Mottie
Copy link
Owner

Mottie commented Jul 24, 2018

Done 😸

@ZeeCoder
Copy link
Author

🎉 Awesome, thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants