You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository has been archived by the owner on Dec 15, 2022. It is now read-only.
Being a very modular project, Atom has a lot of changes happening across a lot of repos. This can make it quite a challenge to keep track of all the changes being made in Atom from version to version. Unfortunately, that has sort of meant that our release notes end up being rather bare-bones summaries of what's changed in any particular version, rather than complete, well, changelogs. In addition, none of our bundled packages or libraries have any release notes at all right now - it's only Atom core.
I think it's important to publicly document every significant change we make to Atom across all of our repos, which should make it a lot easier for users to know what to expect from each release, and hopefully help prevent surprises like atom/toggle-quotes@8899f00#commitcomment-12552713 or atom/atom#8226.
Proposal
Add CHANGELOG.md files to each package and library repo (or leverage GitHub Releases)
I'm personally 👍 for CHANGELOG.md files - they're version-controlled, simple to update, easy to discover, and will be displayed properly in settings-view.
Add a CHANGELOG.md to atom/atom to be used exclusively for core changes
Update them individually with each significant changes as they are made
Concatenate and organize all changelogs for atom.io/releases
For UI here it might be nice to take some inspiration from Firefox release notes - default to the short summary display, and offer a "view full list of changes" option for those who really want to dig deeper.
Maybe even add the ability to filter by package / library?
atom/atom release notes (ie. the notes used in GitHub Releases, rather than the CHANGELOG.md) can continue to work as the short summary of what changed.
In the client, you could reuse the cards UI to represent the updated modules on the changelog page, expanding on click if the users wants to know more about what changed in that package that was included with the Atom update. Might be a lot of wasted space though..
From @mnquintana on August 5, 2015 22:17
Challenge
Being a very modular project, Atom has a lot of changes happening across a lot of repos. This can make it quite a challenge to keep track of all the changes being made in Atom from version to version. Unfortunately, that has sort of meant that our release notes end up being rather bare-bones summaries of what's changed in any particular version, rather than complete, well, changelogs. In addition, none of our bundled packages or libraries have any release notes at all right now - it's only Atom core.
I think it's important to publicly document every significant change we make to Atom across all of our repos, which should make it a lot easier for users to know what to expect from each release, and hopefully help prevent surprises like atom/toggle-quotes@8899f00#commitcomment-12552713 or atom/atom#8226.
Proposal
CHANGELOG.md
files to each package and library repo (or leverage GitHub Releases)CHANGELOG.md
files - they're version-controlled, simple to update, easy to discover, and will be displayed properly in settings-view.CHANGELOG.md
to atom/atom to be used exclusively for core changesCHANGELOG.md
) can continue to work as the short summary of what changed./cc @atom/feedback
Copied from original issue: atom/atom#8240
The text was updated successfully, but these errors were encountered: