mirrors/brew

0 Fork 0

mirror of https://github.com/Homebrew/brew.git synced 2026-10-28 17:44:43 +08:00

Files

T

Mike McQuaid 3264f71d24 Merge pull request #24193 from xrl/api-revalidate-stale-cache

api: revalidate JSON API caches with ETag, not the bumped mtime

2026-10-17 12:35:53 +00:00

_layouts

base.html: update to match main configuration

2026-10-01 08:07:14 +00:00

assets/img/docs

docs: drop advice to disable security or lower support tier

2026-06-15 16:41:01 +01:00

bin

jekyll: update to match main configuration

2026-08-05 01:33:32 +00:00

governance

Update package manager slogan

2026-07-26 19:48:28 +01:00

script

bootstrap: update to match main configuration

2026-08-05 01:33:32 +00:00

vale-styles/Homebrew

docs/Cask-Cookbook: align with cask standards

2026-09-06 21:41:08 +10:00

_config.yml

Update package manager slogan

2026-07-26 19:48:28 +01: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

docs: add mdl for Markdown linting

2021-12-02 22:58:31 -05:00

.rubocop.yml

rubocop: Always run the "every formula should have a test block" check

2026-10-10 18:19:08 +01:00

.ruby-version

Further Portable Ruby cleanup

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

Acceptable-Casks.md

Explain Cask Gatekeeper security model

2026-08-25 13:19:55 +01:00

Acceptable-Formulae.md

docs: implementlists for readability

2026-07-23 10:20:25 +10:00

Adding-Software-to-Homebrew.md

docs/Adding-Software-to-Homebrew: pass the package type to brew style

2026-07-20 10:01:34 -07:00

Advisory-Matching.md

advisory-match: reuse platform-independent history

2026-10-10 11:27:58 -07:00

AGENTS.md

docs: enforce sentence-case headings and codify prose conventions

2026-07-20 13:29:18 -07:00

Analytics.md

Sample only user-set env config in analytics

2026-07-24 19:40:08 +01:00

Autobump.md

Change RubyDoc links

2025-10-15 17:39:14 +01:00

Bottles.md

Relocate prefixes split across x86-64 operands

2026-09-23 14:25:12 -05:00

Brew-Bundle-and-Brewfile.md

Prefer Homebrew Python for uv tools

2026-09-17 09:50:27 +01:00

Brew-Livecheck.md

docs: remove references to deleted homebrew-cask helper scripts

2026-09-05 00:32:13 +10:00

Brewfile

docs/Brewfile: use unversioned Ruby formula

2026-03-23 19:11:33 -07:00

BrewTestBot-For-Maintainers.md

docs: update maintainer operations guides

2026-07-20 11:47:25 -07:00

BrewTestBot.md

docs: update maintainer operations guides

2026-07-20 11:47:25 -07:00

Building-Against-Non-Homebrew-Dependencies.md

docs: update formula authoring and toolchain references

2026-07-20 09:50:52 -07:00

C++-Standard-Libraries.md

docs: update formula authoring and toolchain references

2026-07-20 09:50:52 -07:00

Cask-Cookbook.md

Unify formula and cask description guidelines

2026-10-14 23:34:49 +11:00

Checksum-Requirements.md

docs/Checksum-Requirements: cover casks in the shared requirement

2026-07-18 23:40:26 -07:00

CNAME

Cleanup documentation site

2017-01-04 10:53:21 +00:00

Command-Not-Found.md

docs: update command and integration references

2026-07-18 23:34:31 -07:00

Common-Issues-for-Maintainers.md

docs: update maintainer operations guides

2026-07-20 11:47:25 -07:00

Common-Issues.md

Clear cached receipts after source builds

2026-09-26 17:17:06 +08: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

docs: update formula authoring and toolchain references

2026-07-20 09:50:52 -07:00

Deprecating-Disabling-and-Removing.md

Deprecate Homebrew wrapper configuration

2026-09-13 08:45:07 +01:00

Description-Guidelines.md

Unify formula and cask description guidelines

2026-10-14 23:34:49 +11:00

docs_rubocop_style.yml

Fix/reenable brew style docs

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

Expense-and-Reimbursement-Policy.md

docs: implementlists for readability

2026-07-23 10:20:25 +10:00

External-Commands.md

docs: update command and integration references

2026-07-18 23:34:31 -07:00

FAQ.md

Update FAQ.md -- add support caveat to macOS Intel path note

2026-10-01 13:54:59 -04:00

Formula-Cookbook.md

Preserve and validate no_linkage metadata

2026-10-15 07:38:40 +00:00

Gemfile

Gemfiles: require a minimum Ruby version

2026-09-15 11:48:52 -07:00

Gemfile.lock

build(deps): bump the bundler group across 2 directories with 9 updates

2026-10-16 08:07:00 +00:00

Homebrew-brew-Maintainer-Guide.md

docs: update maintainer operations guides

2026-07-20 11:47:25 -07:00

Homebrew-for-Mac-Admins.md

Add as-brew-user and support MDM deployment

2026-09-23 09:45:53 -05:00

Homebrew-Governance-Archives.md

docs: restyle governance and maintainer process pages

2026-07-18 23:34:31 -07:00

Homebrew-Governance.md

Homebrew-Governance.md: update to match main configuration

2026-10-14 13:57:52 +00:00

Homebrew-homebrew-cask-Maintainer-Guide.md

docs: update maintainer operations guides

2026-07-20 11:47:25 -07:00

Homebrew-homebrew-core-Maintainer-Guide.md

docs: implementlists for readability

2026-07-23 10:20:25 +10:00

Homebrew-Leadership-Responsibilities.md

Homebrew-Leadership-Responsibilities.md: update to match main configuration

2026-10-01 08:07:14 +00:00

Homebrew-on-Linux.md

Add as-brew-user and support MDM deployment

2026-09-23 09:45:53 -05:00

Homebrew-Security-and-Supply-Chain.md

Disclaim sandbox TCC responsibility when available

2026-10-16 22:14:56 +01:00

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

docs: implementlists for readability

2026-07-23 10:20:25 +10:00

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

docs: update tap trust and supply-chain documentation

2026-07-18 23:26:45 -07:00

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

Clarify package commit squashing

2026-09-11 11:45:22 +01:00

How-To-Organise-the-AGM.md

docs: restyle governance and maintainer process pages

2026-07-18 23:34:31 -07:00

index.md

Unify formula and cask description guidelines

2026-10-14 23:34:49 +11:00

index.mdl_style.rb

docs: improve docs.

2026-06-08 20:35:04 +01:00

Installation.md

Update Installation.md - Remove reference to install script support for macOS Intel

2026-10-01 13:31:55 -04:00

Interesting-Taps-and-Forks.md

Rename Homebrew security docs page

2026-06-21 13:56:57 +01:00

Kickstarter-Supporters.md

Review some docs

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

Language-Runtimes-and-Packages.md

docs: implementlists for readability

2026-07-23 10:20:25 +10:00

Language-Specific-Formulae.md

pypi: resolve non-PyPI sources missing from PyPI

2026-09-19 18:20:41 +09:00

Licence-Guidelines.md

docs: rename checksum and licence reference pages

2026-07-18 23:20:51 -07:00

Linux-CI.md

Migrate to Ubuntu 24.04

2026-05-09 08:58:42 -04:00

Maintainer-Guidelines.md

Update package manager slogan

2026-07-26 19:48:28 +01:00

Maintainer-Stipends-and-Grants.md

docs: fix errors reported by Vale 3.17.0

2026-07-31 14:51:00 -07:00

Maintainers-Avoiding-Burnout.md

docs: update maintainer operations guides

2026-07-20 11:47:25 -07:00

Manpage.md

Merge pull request #24174 from Homebrew/interactive-fetch-shell

2026-10-06 15:46:56 +00:00

MCP-Server.md

docs/MCP-Server: update Cursor URL

2026-08-03 13:11:24 -07:00

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

Review some docs

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

New-Maintainer-Checklist.md

docs: update maintainer operations guides

2026-07-20 11:47:25 -07:00

Package-Acceptance-Policy.md

audit: require livecheck for new packages

2026-10-17 21:08:39 +11:00

Prose-Style-Guidelines.md

docs: enforce sentence-case headings and codify prose conventions

2026-07-20 13:29:18 -07:00

Querying-Brew.md

docs: update command and integration references

2026-07-18 23:34:31 -07:00

Rakefile

Ignore Ubuntu release list link check failures

2026-10-08 16:25:28 +01:00

README.md

docs: improve docs.

2026-06-08 20:35:04 +01:00

Releases.md

Block releases on open release blockers

2026-07-24 19:20:36 +01:00

Rename-A-Formula.md

docs: update formula authoring and toolchain references

2026-07-20 09:50:52 -07:00

Reproducible-Builds.md

docs: update formula authoring and toolchain references

2026-07-20 09:50:52 -07:00

Responsible-AI-Usage.md

Enforce responsible AI contribution policy

2026-07-29 09:53:23 +01:00

robots.txt

docs: Add sitemap.xml, robots.txt.

2017-07-02 15:09:26 +01:00

Shell-Completion.md

docs: address review comments on platform pages

2026-07-19 09:01:13 -07:00

Support-Tiers.md

Add as-brew-user and support MDM deployment

2026-09-23 09:45:53 -05:00

Tap-Trust.md

Require canonical names for formula trust

2026-10-07 14:28:40 +01:00

Taps.md

docs/Taps: split the trust example into its two alternatives

2026-07-18 23:40:50 -07:00

Tips-and-Tricks.md

Keep API cache bodies and validators consistent

2026-10-17 13:21:00 +01:00

Troubleshooting.md

Fix two dead links in the docs

2026-09-02 19:26:43 +05:30

Typechecking.md

docs/Typechecking: note that some RBI files are handwritten

2026-07-20 12:40:19 -07:00

Updating-Software-in-Homebrew.md

Fix typos, grammar and Cachable module name

2026-09-13 19:31:21 -05:00

Versions.md

docs: add a shared package acceptance policy

2026-07-19 09:10:44 -07:00

Working-with-Homebrew-as-an-Upstream-Project.md

docs: clarify upstream expectations

2026-04-26 12:39:01 +01:00

Xcode.md

Stop inferring Xcode versions from clang

2026-10-06 10:19:24 -07:00

README.md

last_review_date

last_review_date
2026-06-08

Homebrew Documentation

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 http://localhost:4000, run:

cd $(brew --repository)/docs
brew bundle --install exec -- bundle install
bin/jekyll serve