In that case, the use of SHA-256 ought to be documented in the [Formula Cookbook](https://github.com/Homebrew/homebrew/wiki/Formula-Cookbook) because the SHA-256 issues in the tracker are confusing since they speak of replacing SHA-1 with SHA-256 for all new formulae.