8 Commits

Author SHA1 Message Date
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
Caleb Xu
c5070e2c7e
docs: mention optional replacement parameter for deprecate/disable 2024-11-24 07:52:47 -05:00
Bevan Kay
b544934fbf
docs/Deprecating-Disabling-and-Removing-Casks.md: add cask deprecate/disable reasons 2024-02-25 19:58:35 +11:00
Mike McQuaid
efbc4683aa
Update docs/Deprecating-Disabling-and-Removing-Casks.md
Co-authored-by: Bo Anderson <mail@boanderson.me>
2024-02-14 17:11:52 +00:00
Mike McQuaid
ba1c0951e9
Update docs/Deprecating-Disabling-and-Removing-Casks.md
Co-authored-by: Michael Cho <michael@michaelcho.dev>
2024-02-14 17:11:44 +00:00
Mike McQuaid
32abc3b1e6
Update docs/Deprecating-Disabling-and-Removing-Casks.md
Co-authored-by: Bo Anderson <mail@boanderson.me>
2024-02-14 17:11:09 +00:00
Mike McQuaid
2cdfea71e7
Apply suggestions from code review
Co-authored-by: Bo Anderson <mail@boanderson.me>
2024-02-14 08:48:01 +00:00
Mike McQuaid
63e1c540fd
Update Acceptable/Deprecating/Forks/Versions docs
As discussed at the AGM:
- Only allow formula/cask forks to be used when either blessed by
  the source or used by two other major distributions,
- Further elaborate and tweak reasons to deprecate/disable formulae.
- Allow more versioned formulae when widely used.
- Add a document (based on above) for deprecating/disabling casks.

While we're here:
- let VSCode Markdown linting remove the trailing `!` from an
  Acceptable Casks heading
2024-02-13 10:13:44 +00:00