Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Release 3.2.0#1338

Merged
patrick96 merged 2 commits into
polybar:masterfrom
patrick96:release-3.2.0
Jul 23, 2018
Merged

Release 3.2.0#1338
patrick96 merged 2 commits into
polybar:masterfrom
patrick96:release-3.2.0

Conversation

@patrick96

@patrick96 patrick96 commented Jul 22, 2018

Copy link
Copy Markdown
Member

I think the 3.2.0 release is badly needed right now, for one because xcb-proto 1.13 is getting more and more common, making the 'eventstruct' issue (#973) catch on (see #1335, #1330, #1294, #1252, #1233, #1090, #1114) and also 3.1.0 cannot be compiled with gcc 8 without manually updating the i3ipcpp submodule.

The 3.2.0 Milestone contained quite a few unfinished issues, I have moved almost all of them into the 3.3.0 Milestone because this release now has some urgency to it.
The only issue I kept was #1194, because there is already a fix for it (#1198), it just needs to be reviewed and merged.

With this release, I'd like to also propose some guidelines on how we do releases. The base idea is that each minor (and major) release (like 3.0.0, 3.1.0, 3.2.0, etc) gets its own branch. The name of the branch is the version number with the patch number dropped (e.g. 3.2, 4.0, etc) so that we don't get any conflicts with the git tags for the versions (that's why in the README I used --branch 3.2). Development continues on master, no actual work is done directly in the release branches. If we need to release a patch version (e.g. 3.2.1), for example because of a critical bug, we cherry-pick the commit that fixes the bug onto the current release branch (Note: The 3.2.1 tag is only present in the release branch, the master branch now only contains the tags for minor and major releases). So we basically backport the fixes, this way we don't have to create minor releases for every bug, just because we implemented a feature in the meantime. It also prevents the behaviour we have now, where we have to patch up the PKGBUILDs and write extra instructions just to get the current version to compile.

I'd like to get your feedback on these release guidelines, if you approve, I will write a page on the wiki with a release protocol.

Things to do before merging:

  • Write changelog and add it to the github release tag
  • Check if all new features are documented on the wiki

Things to do after this is merged:

  • Remove (unreleased) note from new features in the wiki
  • Create the 3.2 branch with this PR as its base commit.
  • Publish drafted release with target on the 3.2 branch
  • Ensure AUR packages build properly and have proper version tags
  • Push updated PKGBUILDs (and .SRCINFO)

@NBonaparte could you please review #1198 so that we can fix that bug for this release.

The temporary fixes in polybar.git's prepare() function can be removed
because they are now part of the release
@patrick96 patrick96 added this to the 3.2.0 milestone Jul 22, 2018
@patrick96 patrick96 self-assigned this Jul 22, 2018
@patrick96 patrick96 requested review from NBonaparte and jaagr July 22, 2018 17:31
@NBonaparte

Copy link
Copy Markdown
Member

Sounds good.

It might also be nicer to do more frequent minor releases because we usually end up having a large backlog of features, fixes, etc. We should have some metric to determine when to release, especially if some PRs in the milestone take longer than expected.

@patrick96

Copy link
Copy Markdown
Member Author

I agree, we should maybe limit our milestones to 5 or 6 features and if they're done, just do a release. If only one of them is holding the others back, we just move it to the next milestone and continue with the release.

@patrick96

Copy link
Copy Markdown
Member Author

Will try to finally release this thing tomorrow and nicely write up the release guidelines.

@patrick96 patrick96 merged commit 934e277 into polybar:master Jul 23, 2018
@patrick96

Copy link
Copy Markdown
Member Author

I have written down the guidelines in the wiki, if you want to read them

@patrick96 patrick96 deleted the release-3.2.0 branch July 23, 2018 13:42
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