admin/brew

History

Carlo Cabrera 6214ce3024

Update documentation on deprecating and disabling formulae

This is based on the discussion at Homebrew/homebrew-core#91368.

A few reasons why we don't want to deprecate formulae that have
dependents:

1. This results in displaying warning messages to (at least some) users
   that they can't do anything about.
2. `test-bot` does not test deprecated formulae, so we risk breaking
   dependent formulae when one of its dependencies is not tested.
3. It is much harder to commit to a disable date for formulae with
   dependents because we don't know when we'll be able to wean
   dependents off of a deprecated formula.

I think it's important to have a disable date in mind when we deprecate
formulae. Otherwise, we might end up leaving formulae deprecated
indefinitely. This is bad because it teaches users to not take
deprecation warnings seriously.

2022-01-16 00:43:41 +08:00

..

assets/img/docs

style: trim trailing whitespaces

2021-09-15 15:00:23 +08:00

vale-styles/Homebrew

Cleanup more linuxbrew-core code

2021-10-21 09:00:22 +01:00

_config.yml

Add Vale linting for our docs

2019-12-17 21:42:53 +00:00

.mdl_ruleset.rb

docs: add mdl for Markdown linting

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

.mdl_style.rb

docs: add mdl for Markdown linting

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

.mdlrc

docs: add mdl for Markdown linting

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

Acceptable-Casks.md

Update docs/Acceptable-Casks.md

2021-08-23 21:49:19 +03:00

Acceptable-Formulae.md

docs/Acceptable-Formulae: specifiy the list of supported platforms

2021-11-18 11:49:55 +00:00

Adding-Software-to-Homebrew.md

docs: incorporate suggestions

2021-12-23 09:47:20 +01:00

Analytics.md

Update Analytics.md

2021-11-16 09:26:29 -05:00

Bottles.md

Update Bottles.md

2021-11-16 09:26:29 -05:00

Brew-Livecheck.md

docs: add livecheck formula/cask reference example

2021-08-02 09:12:23 -04:00

Brew-Test-Bot-For-Core-Contributors.md

docs: update for new autosquash on automerge

2020-10-13 23:19:22 +11:00

Brew-Test-Bot.md

docs: restore h1 headings for pages with front matter

2020-06-11 14:04:12 -04:00

Building-Against-Non-Homebrew-Dependencies.md

docs: talk about custom Requirements

2020-09-09 19:21:22 +10:00

C++-Standard-Libraries.md

Update deprecations

2019-01-08 19:13:46 +00:00

Cask-Cookbook.md

cask: add #csv to version DSL

2021-11-16 16:34:12 -08:00

Checksum_Deprecation.md

Checksum_Deprecation: tweak phrasing/explanation/etc

2017-10-22 05:31:53 +01:00

CNAME

Cleanup documentation site

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

Common-Issues-for-Core-Contributors.md

pr-upload: add --no-commit flag

2020-10-03 12:36:46 -04:00

Common-Issues.md

docs/Common-Issues.md: fix variable notation

2021-12-27 03:06:37 +01:00

Creating-a-Homebrew-Issue.md

Docs: Add guides for common cases

2020-02-25 21:43:03 +01:00

Custom-GCC-and-cross-compilers.md

docs: update cross-compiler practice in core

2020-09-09 19:21:22 +10:00

Deprecating-Disabling-and-Removing-Formulae.md

Update documentation on deprecating and disabling formulae

2022-01-16 00:43:41 +08:00

Diagram-Guidelines.md

Apply suggested changes to diagram and guidelines

2020-09-07 23:51:33 +02:00

External-Commands.md

Add & remove line breaks

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

FAQ.md

Update FAQ.md

2021-12-02 22:59:00 -05:00

Formula-Cookbook.md

Update Formula-Cookbook.md gsub! example

2021-10-19 13:20:16 -07:00

Gemfile

docs: add mdl for Markdown linting

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

Gemfile.lock

build(deps): bump ffi from 1.15.4 to 1.15.5 in /docs

2022-01-11 02:42:41 +00:00

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

Add & remove line breaks

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

Homebrew-and-Java.md

Add initial documentation for Java-based packages

2021-03-02 08:42:17 -08:00

Homebrew-and-Python.md

Add & remove line breaks

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

Homebrew-brew-Maintainer-Guide.md

update: migrate everyone from linuxbrew-core to homebrew-core

2021-10-20 11:01:38 +01:00

Homebrew-Governance.md

Add hyperlinks for election methods

2021-02-17 00:26:03 +00:00

Homebrew-homebrew-cask-Maintainer-Guide.md

docs: update based on suggestions from code review

2021-05-18 02:39:33 -04:00

Homebrew-homebrew-core-Maintainer-Guide.md

Cleanup more linuxbrew-core code

2021-10-21 09:00:22 +01:00

Homebrew-linuxbrew-core-Maintainer-Guide.md

Cleanup more linuxbrew-core code

2021-10-21 09:00:22 +01:00

Homebrew-on-Linux.md

Update Homebrew-on-Linux.md

2021-12-02 22:59:00 -05:00

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

style: fix inconsistent code style for shell scripts

2021-09-15 14:59:01 +08:00

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

docs/create-tap: remove nbsp

2020-10-22 19:25:07 -04:00

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

docs: incorporate suggestions

2021-12-23 09:47:20 +01:00

Installation.md

Update Installation.md

2021-12-02 22:59:00 -05:00

Interesting-Taps-and-Forks.md

Update Interesting-Taps-and-Forks.md

2021-11-16 09:26:29 -05:00

Kickstarter-Supporters.md

docs: change my kickstarter homepage

2021-10-16 11:35:28 +02:00

License-Guidelines.md

docs: add reference to :cannot_represent license

2020-10-22 10:24:12 -04:00

Maintainer-Guidelines.md

update: migrate everyone from linuxbrew-core to homebrew-core

2021-10-20 11:01:38 +01:00

Maintainers-Avoiding-Burnout.md

docs: various updates.

2018-09-06 15:07:00 +01:00

Manpage.md

Update maintainers, manpage and completions.

2022-01-13 10:37:47 +00:00

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

docs: don't migrate formulae out of core/cask

2020-09-09 19:21:22 +10:00

New-Maintainer-Checklist.md

Remove some SFC references.

2021-12-07 15:48:37 +00:00

Node-for-Formula-Authors.md

docs: update outdated formula references for Node

2020-09-09 19:21:22 +10:00

Prose-Style-Guidelines.md

Use Title Case in h1 headings and sentence case in all others

2019-12-18 16:09:07 +00:00

Python-for-Formula-Authors.md

docs: update homebrew-pypi-poet instructions

2021-01-07 13:24:18 -05:00

Querying-Brew.md

docs/querying-brew: point to brew info --help.

2019-01-30 21:39:56 +00:00

Rakefile

docs: add mdl for Markdown linting

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

README.md

Cleanup more linuxbrew-core code

2021-10-21 09:00:22 +01:00

Releases.md

docs/Releases: note to remember to delete disabled arguments

2021-12-17 02:02:45 +00:00

Rename-A-Formula.md

brew audit --strict is not enough

2021-03-18 20:48:25 -04:00

robots.txt

docs: Add sitemap.xml, robots.txt.

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

Shell-Completion.md

Update Shell-Completion.md

2021-12-02 22:59:00 -05:00

Taps.md

Update Taps.md

2021-11-16 09:31:29 -05:00

Tips-N'-Tricks.md

Update Tips-N'-Tricks.md

2021-11-16 09:31:29 -05:00

Troubleshooting.md

Update Troubleshooting.md

2021-12-02 22:59:01 -05:00

Typechecking.md

Update type checking documentation.

2020-12-13 03:39:15 +01:00

Updating-Software-in-Homebrew.md

docs: integrate suggested changes

2022-01-08 11:30:51 +02:00

Versions.md

Update docs/Versions.md

2021-11-26 13:30:28 +00:00

Xcode.md

docs/Xcode: fix CLT method name

2021-12-07 14:43:48 +00:00

README.md

Documentation

Users

Contributors

Maintainers

Governance

Homebrew Governance