diff --git a/Library/Homebrew/official_taps.rb b/Library/Homebrew/official_taps.rb index 0f043c73b4..eecf8e50ef 100644 --- a/Library/Homebrew/official_taps.rb +++ b/Library/Homebrew/official_taps.rb @@ -7,7 +7,6 @@ OFFICIAL_TAPS = %w[ emacs fuse games - head-only nginx php python diff --git a/share/doc/homebrew/Acceptable-Formulae.md b/share/doc/homebrew/Acceptable-Formulae.md index 9554c8b3db..d59972ff61 100644 --- a/share/doc/homebrew/Acceptable-Formulae.md +++ b/share/doc/homebrew/Acceptable-Formulae.md @@ -66,9 +66,12 @@ Formulae in the core repository must have a stable version tagged by the upstream project. Tarballs are preferred to git checkouts, and tarballs should include the version in the filename whenever possible. -Software that does not provide a stable, tagged version, or had guidance to -always install the most recent version, should be put in -[homebrew/head-only](https://github.com/Homebrew/homebrew-head-only) or [homebrew/devel-only](https://github.com/Homebrew/homebrew-devel-only). +Software that only provides a development/beta, tagged version should be put in +[homebrew/devel-only](https://github.com/Homebrew/homebrew-devel-only). +We don’t accept software without a tagged version because they regularly break +due to upstream changes; we can’t provide [bottles](Bottles.md) for them; and +we don’t have an automatic update mechanism for `head-only` formulae which +makes them very quickly outdated. ### Bindings First check that there is not already a binding available via diff --git a/share/doc/homebrew/Formula-Cookbook.md b/share/doc/homebrew/Formula-Cookbook.md index ac6f8a85ee..356ae28142 100644 --- a/share/doc/homebrew/Formula-Cookbook.md +++ b/share/doc/homebrew/Formula-Cookbook.md @@ -67,7 +67,7 @@ Before contributing, make sure your package: * isn't in another [Homebrew tap](https://github.com/Homebrew) * isn't already waiting to be merged (check the [issue tracker](https://github.com/Homebrew/homebrew/issues)) * is still supported by upstream -* has a stable, tagged version (i.e. not just a GitHub repository with no versions). See [Interesting-Taps-&-Branches](Interesting-Taps-&-Branches.md) for where pre-release and head-only versions belong. +* has a stable, tagged version (i.e. not just a GitHub repository with no versions). See [Interesting-Taps-&-Branches](Interesting-Taps-&-Branches.md) for where pre-release versions belong. * passes all `brew audit --strict --online $FORMULA` tests. Make sure you search thoroughly (all aliases!). We don’t want you to waste your time. diff --git a/share/doc/homebrew/Interesting-Taps-&-Branches.md b/share/doc/homebrew/Interesting-Taps-&-Branches.md index 9313be3596..93d0168c48 100644 --- a/share/doc/homebrew/Interesting-Taps-&-Branches.md +++ b/share/doc/homebrew/Interesting-Taps-&-Branches.md @@ -22,7 +22,7 @@ Homebrew has the capability to add (and remove) multiple taps to your local inst * [homebrew/games](https://github.com/Homebrew/homebrew-games): Game or gaming-emulation related formulae. -* [homebrew/head-only](https://github.com/Homebrew/homebrew-head-only): A tap for brews that only have unstable, unreleased versions. +* [homebrew/head-only](https://github.com/Homebrew/homebrew-head-only): A tap for brews that only have unstable, unreleased versions. This tap is **deprecated** and doesn’t accept new formulae. * [homebrew/nginx](https://github.com/Homebrew/homebrew-nginx): Feature rich Nginx tap for modules.