brew/docs/Updating-Software-in-Homebrew.md
Issy Long 31d7bcc583
Add a last_reviewed_date to docs metadata
- At the AGM we formed an ad-hoc documentation working group.
- One of our ideas was that we should have a last reviewed date for
  documentation, so that we can periodically implement a review
  mechanism (GitHub Actions posts to Slack for a regular documentation
  outdatedness check?) to track how old docs are and ensure they're
  still relevant.
- This is a first step towards that goal, by adding a `last_review_date`
  to the metadata of all docs with a date of earlier than Homebrew's
  inception because everything needs reviewing so that we start from a
  good base!
2025-02-03 11:56:07 +00:00

1.9 KiB

last_review_date
last_review_date
1970-01-01

Updating Software in Homebrew

Did you find something in Homebrew that wasn't the latest version? You can help yourself and others by submitting a pull request to update the formula.

First, check the pull requests in the Homebrew tap repositories to make sure a PR isn't already open. If you're submitting a formula, check homebrew-core. If you're submitting a cask, check homebrew-cask. You may also want to look through closed pull requests in the repositories, as sometimes packages run into problems preventing them from being updated and it's better to be aware of any issues before putting significant effort into an update.

The How to Open a Homebrew Pull Request documentation should explain most everything you need to know about the process of creating a PR for a version update. For simple updates, this typically involves changing the url and sha256 values.

However, some updates require additional changes to the package. You can look back at previous pull requests to see how others have handled things in the past, but be sure to look at a variety of PRs. Sometimes packages aren't updated properly, so you may need to use your judgment to determine how best to proceed.

Once you've created the pull request in the appropriate Homebrew repository your commit(s) will be tested on our continuous integration servers, showing a green check mark if everything passed or a red X if there were failures. Maintainers will review your pull request and provide feedback about any changes that need to be made before it can be merged.

We appreciate your help in keeping Homebrew's repositories up to date as new versions of software are released!