admin/brew

History

Ensure that head Git URLs always specify a branch

- There's a TODO on the "someday" list [1] to ensure that `head` Git
  URLs always specify a branch.
- So I thought I'd automate this worry by adding an audit.
- Since `resource` block URLs tend to be pinned to SHAs, if indeed
  they are Git URLs, this audit only applies to `head` URLs.

[1]: https://github.com/orgs/Homebrew/projects/5?pane=issue&itemId=98789749

2025-08-10 20:28:50 +01:00

assets/img/docs

Delete ancient 'managing PRs' flowchart

2024-02-05 01:47:55 +01:00

bin

docs: improve/fix jekyll setup

2025-04-25 09:46:29 +01:00

governance

Switch to using main as the default branch

2025-06-24 11:14:57 +01:00

vale-styles/Homebrew

docs: localize internal URLs

2025-05-22 12:17:52 -04:00

_config.yml

Use SVG logo in header

2024-03-31 21:46:25 +02:00

.mdl_ruleset.rb

docs: localize internal URLs

2025-05-22 12:17:52 -04:00

.mdl_style.rb

docs: brew style --fix

2024-06-13 09:55:31 +01:00

.mdlrc

…

.rubocop.yml

Fix RuboCop failures.

2025-07-14 19:12:38 +01:00

.ruby-version

Further Portable Ruby cleanup

2024-06-14 12:22:02 +01:00

Acceptable-Casks.md

docs: localize internal URLs

2025-05-22 12:17:52 -04:00

Acceptable-Formulae.md

Switch to using main as the default branch

2025-06-24 11:14:57 +01:00

Adding-Software-to-Homebrew.md

docs: homebrew-cask's default branch is now main

2025-06-25 08:50:36 +01:00

Analytics.md

Add a last_reviewed_date to docs metadata

2025-02-03 11:56:07 +00:00

Autobump.md

docs: apply suggestions from code review

2025-08-07 14:25:20 +02:00

Bottles.md

Add a last_reviewed_date to docs metadata

2025-02-03 11:56:07 +00:00

Brew-Bundle-and-Brewfile.md

Switch to using main as the default branch

2025-06-24 11:14:57 +01:00

Brew-Livecheck.md

docs: suggestions from code review

2025-06-25 15:30:06 +02:00

Brewfile

docs: improve/fix jekyll setup

2025-04-25 09:46:29 +01:00

BrewTestBot-For-Maintainers.md

fixup! Update docs/BrewTestBot-For-Maintainers.md

2025-02-03 17:42:50 +01:00

BrewTestBot.md

Review some docs

2025-02-08 14:43:49 +00:00

Building-Against-Non-Homebrew-Dependencies.md

Add a last_reviewed_date to docs metadata

2025-02-03 11:56:07 +00:00

C++-Standard-Libraries.md

Add a last_reviewed_date to docs metadata

2025-02-03 11:56:07 +00:00

Cask-Cookbook.md

docs: apply suggestions from code review

2025-08-07 14:25:20 +02:00

Checksum_Deprecation.md

Add a last_reviewed_date to docs metadata

2025-02-03 11:56:07 +00:00

CNAME

…

Common-Issues-for-Core-Contributors.md

Switch to using main as the default branch

2025-06-24 11:14:57 +01:00

Common-Issues.md

Switch to using main as the default branch

2025-06-24 11:14:57 +01:00

Creating-a-Homebrew-Issue.md

docs/Tips-and-Tricks: rename from weird filename.

2025-04-25 09:46:29 +01:00

Custom-GCC-and-cross-compilers.md

Add a last_reviewed_date to docs metadata

2025-02-03 11:56:07 +00:00

Deprecating-Disabling-and-Removing-Casks.md

docs: mention signing in deprecation criteria

2025-08-06 10:29:59 -04:00

Deprecating-Disabling-and-Removing-Formulae.md

docs: mention signing in deprecation criteria

2025-08-06 10:29:59 -04:00

docs_rubocop_style.yml

Fix/reenable brew style docs

2024-06-13 12:31:47 +01:00

External-Commands.md

Cleanup and fix homebrew-services migration

2025-03-13 15:22:01 +00:00

FAQ.md

docs: localize internal URLs

2025-05-22 12:17:52 -04:00

Formula-Cookbook.md

Ensure that head Git URLs always specify a branch

2025-08-10 20:28:50 +01:00

Gemfile

docs: improve/fix jekyll setup

2025-04-25 09:46:29 +01:00

Gems,-Eggs-and-Perl-Modules.md

Add a last_reviewed_date to docs metadata

2025-02-03 11:56:07 +00:00

Homebrew-and-Java.md

Add a last_reviewed_date to docs metadata

2025-02-03 11:56:07 +00:00

Homebrew-and-Python.md

docs: localize internal URLs

2025-05-22 12:17:52 -04:00

Homebrew-brew-Maintainer-Guide.md

Switch to using main as the default branch

2025-06-24 11:14:57 +01:00

Homebrew-Governance-Archives.md

Add a last_reviewed_date to docs metadata

2025-02-03 11:56:07 +00:00

Homebrew-Governance.md

docs/Homebrew-Governance.md: fix broken link

2025-02-13 10:56:13 +11:00

Homebrew-homebrew-cask-Maintainer-Guide.md

Switch to using main as the default branch

2025-06-24 11:14:57 +01:00

Homebrew-homebrew-core-Maintainer-Guide.md

docs: homebrew-core's default branch is now main

2025-06-25 08:49:58 +01:00

Homebrew-Leadership-Responsibilities.md

Switch to using main as the default branch

2025-06-24 11:14:57 +01:00

Homebrew-on-Linux.md

docs/Homebrew-on-Linux: update dnf5 syntax, centos/rhel section

2025-07-04 06:55:18 +03:00

How-to-Build-Software-Outside-Homebrew-with-Homebrew-keg-only-Dependencies.md

Add a last_reviewed_date to docs metadata

2025-02-03 11:56:07 +00:00

How-to-Create-and-Maintain-a-Tap.md

Import brew alias and brew unalias commands

2025-02-07 14:31:50 +00:00

How-To-Open-a-Homebrew-Pull-Request.md

docs: homebrew-core's default branch is now main

2025-06-25 08:49:58 +01:00

How-To-Organize-AGM.md

How-To-Organize-AGM: update link

2025-05-14 16:54:09 -07:00

index.md

docs: add Homebrew's MCP server documentation.

2025-07-18 15:27:11 +01:00

Installation.md

Switch to using main as the default branch

2025-06-24 11:14:57 +01:00

Interesting-Taps-and-Forks.md

Review some docs

2025-02-08 14:43:49 +00:00

Kickstarter-Supporters.md

Review some docs

2025-02-08 14:43:49 +00:00

License-Guidelines.md

Add a last_reviewed_date to docs metadata

2025-02-03 11:56:07 +00:00

Linux-CI.md

Update Linux GCC code.

2025-04-03 12:47:21 +01:00

Maintainer-Guidelines.md

Review some docs

2025-02-08 14:43:49 +00:00

Maintainers-Avoiding-Burnout.md

Review some docs

2025-02-08 14:43:49 +00:00

Manpage.md

Update manpage and completions.

2025-08-05 14:10:26 +00:00

MCP-Server.md

docs: add Homebrew's MCP server documentation.

2025-07-18 15:27:11 +01:00

Migrating-A-Formula-To-A-Tap.md

Review some docs

2025-02-08 14:43:49 +00:00

New-Maintainer-Checklist.md

Switch to using main as the default branch

2025-06-24 11:14:57 +01:00

Node-for-Formula-Authors.md

Switch to using main as the default branch

2025-06-24 11:14:57 +01:00

Prose-Style-Guidelines.md

docs: localize internal URLs

2025-05-22 12:17:52 -04:00

Python-for-Formula-Authors.md

Add a last_reviewed_date to docs metadata

2025-02-03 11:56:07 +00:00

Querying-Brew.md

Review some docs

2025-02-08 14:43:49 +00:00

Rakefile

docs: fix HTML Proofer in CI

2025-06-27 08:09:24 +01:00

README.md

Switch to using main as the default branch

2025-06-24 11:14:57 +01:00

Releases.md

Switch to using main as the default branch

2025-06-24 11:14:57 +01:00

Rename-A-Formula.md

Add a last_reviewed_date to docs metadata

2025-02-03 11:56:07 +00:00

Reproducible-Builds.md

Add a last_reviewed_date to docs metadata

2025-02-03 11:56:07 +00:00

robots.txt

…

Shell-Completion.md

Add PowerShell (pwsh) completion support

2025-03-02 18:17:38 -08:00

Support-Tiers.md

docs/Support-Tiers: tweak wording, add CODEOWNERS.

2025-05-27 14:14:05 +01:00

Taps.md

Remove the sentence referencing --force-auto-update

2025-05-04 23:49:02 -04:00

Tips-and-Tricks.md

Add docs for brew alias command

2025-07-15 13:34:49 -04:00

Troubleshooting.md

Add a last_reviewed_date to docs metadata

2025-02-03 11:56:07 +00:00

Typechecking.md

Switch to using main as the default branch

2025-06-24 11:14:57 +01:00

Updating-Software-in-Homebrew.md

Review some docs

2025-02-08 14:43:49 +00:00

Versions.md

Add a last_reviewed_date to docs metadata

2025-02-03 11:56:07 +00:00

Xcode.md

Add a last_reviewed_date to docs metadata

2025-02-03 11:56:07 +00:00

README.md

last_review_date

last_review_date
1970-01-01

Homebrew Docs

These are the source files for the Homebrew documentation site.

A GitHub Action is run to validate each change before the site is deployed to GitHub Pages.

Usage

Open https://docs.brew.sh in your web browser.

To instead generate the site locally, available on localhost:4000, run:

cd `brew --repository`/docs
bundle install
bundle exec jekyll serve --watch