Missing docs for :github_latest strategy

[thatrobotdev]

Hello! I've been noticing there are a lot of casks with a livecheck stanza that do this:

livecheck do
    url :url
    strategy :github_latest

but I can't find any docs for this in the livecheck stanza docs: https://github.com/Homebrew/homebrew-cask/blob/master/doc/cask_language_reference/stanzas/livecheck.md.

[cho-m]

Homebrew Cask docs probably need to be updated. EDIT: with Cask docs being migrated to central Homebrew docs (#104628), future documentation improvements will have to happen there.

A related issue was #98231, which was for documenting :git strategy.

Homebrew's core rubydoc (https://rubydoc.brew.sh/Homebrew/Livecheck/Strategy.html) lists all available strategies.

Some strategies used in Casks that aren't in the docs for Cask repo include:

• :git - useful for matching on git tags. Default behavior for GitHub Repo URLs if no livecheck stanza.
• :github_latest - useful when GitHub repo redirects https://github.com/<owner>/<repo>/releases/latest to current stable release. Can help ignore pre-releases in :git strategy and regex capture more complicated download URL/filename paths.
• :electron_builder - very specific to electron-builder YAML appcasts.
• :extract_plist - a last-ditch approach for unversioned URLs that requires downloading file.

[carlocab]

FYI, :github_latest should also only be used when really needed, as it involves an API call that is often rate-limited by GitHub.

[github-actions[bot]]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs.