Have a proper CHANGELOG(.md) about .goassets HOT 7 OPEN

@at-wat @Sean-Der Thoughts? Ideas?

from .goassets.

I am behind this 110%

I have had multiple people email me and say Hey this is fixed or Hey this regressed and having a nice CHANGELOG would have made everything so much easier. After fixing the config drift issues @at-wat is doing this is my second biggest organization frustration with Pion.

I am in full support of doing CHANGELOG + standardized commit messages (instead of the arbitrary rules we have right now). @hugoArregui started this here but I just haven't had a chance to get it going everywhere. I am happy with whatever we do! It doesn't matter what direction we move to me, as long as we have something better :)

It's also a bit out of the ordinary compared to most other projects as far as additional things you need to do when contributing.

I am torn. I really want to incentive/reward people that get involved. Especially people that are afraid to get involved in Open Source for the first time. I would be curious if this actually mattered to anyone. If it actually hasn't had an impact I would say delete it. Maybe this is worth a poll we can share via Twitter/Slack?

from .goassets.

Sounds nice to have a CHANGELOG.

Just FYI, I usually work with a middleware Robot Operation System. It has a script to gather commit messages like:

### Forthcoming
- Commit message (#Issue_number)
- Commit message (#Issue_number)

### PREVIOUS_VERSION (DATE)
- Commit message (#Issue_number)
- Commit message (#Issue_number)

and on a new version release, a release script replaces Forthcoming by VERSION (DATE) automatically.

from .goassets.

It's also a bit out of the ordinary compared to most other projects as far as additional things you need to do when contributing.

I am torn. I really want to incentive/reward people that get involved. Especially people that are afraid to get involved in Open Source for the first time. I would be curious if this actually mattered to anyone. If it actually hasn't had an impact I would say delete it. Maybe this is worth a poll we can share via Twitter/Slack?

So, I'm not sure if it has an actual impact. But I got caught by it when submitting this PR, since it's my first one to this repo, and my brain went "huh, that's weird". I honestly don't know if it matters at all, but it was a bit weird to see my PR fail on it.

from .goassets.

Based on my discussion in Slack (starting from this message), I'd like to work on this in the near future.
In short: I'd plan to be using Conventional Commits and probably Standard Version to automatically generate a changelog (and perhaps automated releases if we want to).

from .goassets.

Seems like it's still undecided: automated change log based on commit messages or doing it by hand. IMO, change logs should be maintained by us humans as they are targeted at the user unlike commit messages which are targeted at developers. Commit messages are more technical in nature and more detailed and while some commit messages can be copied directly to the change log, most are too detailed|cryptic for the non-developer.

FYI, There is a github action, mindsers/changelog-reader-action, that reads the changelog (provided we adhere to keepachangelog format) and extracts the version information. Here's how I use it.

from .goassets.

I am adding a link to this comment by Sean about conventional commits:

#143 (comment)

Maybe it could be a way to generate a Changelog automatically

from .goassets.