Since Homebrew 1.0.0 most Homebrew users (those who haven’t run a dev-cmd
orset HOMEBREW_DEVELOPER=1
which is ~99.9% based on analytics data) require tagson the Homebrew/brew repositoryin order to get new versions of Homebrew. There are a few steps in making a newHomebrew release:
- Check the Homebrew/brew pull requests,issues,Homebrew/homebrew-core issues andHomebrew/discussions (forum) to see if there isanything pressing that needs to be fixed or merged before the next release.If so, fix and merge these changes.
- Ensure that no code changes have happened for at least a couple of hours (ideally 4 hours),at least one Homebrew/homebrew-core pull request CI job has completed successfully,checked the state of the Homebrew/brew
master
CI job (i.e. main jobs green or green after rerunning),and that you are confident there are no major regressions on the currentmaster
,branch. - Run
brew release
to create a new draft release. For major or minor version bumps,pass--major
or--minor
, respectively. - Publish the draft release on GitHub.
Homebrew is ranked 2nd while 1Password is ranked 6th. The most important reason people chose Homebrew is: Once installed, you control Homebrew using the.brew. command. You can find packages using.brew search., install them using.brew install. and remove them using.brew uninstall.
If this is a major or minor release (e.g. X.0.0 or X.Y.0) then there are a few more steps:
- Homebrew, iTerm2, and AppCleaner are probably your best bets out of the 76 options considered. 'Open Source' is the primary reason people pick Homebrew over the competition. This page is powered by a knowledgeable community that helps you make an informed decision.
- Participate in discussions with other Treehouse members and learn.
1password Homebrew Extension
- Before creating the tag you should delete any
odisabled
code, make anyodeprecated
codeodisabled
, uncomment any# odeprecated
code and addany newodeprecations
that are desired. - Write up a release notes blog post to https://brew.she.g. brew.sh#319.This should use the output from
brew release [--major|--minor]
as input buthave the wording adjusted to be more human readable and explain not just what has changed but why. - When the release has shipped and the blog post has been merged, tweet theblog post as the @MacHomebrew Twitter accountor tweet it yourself and retweet it with the @MacHomebrew Twitter account(credentials are in 1Password).
- Consider whether to submit it to other sources e.g. Hacker News, Reddit.
- Pros: gets a wider reach and user feedback
- Cons: negative comments are common and people take this as a chance to complain about Homebrew (regardless of their usage)
1password Homebrew Download
Please do not manually create a release based on older commits on the master
branch.It’s very hard to judge whether these have been sufficiently tested by users or if they willcause negative side-effects with the current state of Homebrew/homebrew-core.If a new branch is needed ASAP but there are things on master
that cannot be released yet(e.g. new deprecations and you want to make a patch release) then revert the relevant PRs,follow the process above and then revert the reverted PRs to reapply them on master
.