diff --git a/docs/How-To-Open-a-Homebrew-Pull-Request.md b/docs/How-To-Open-a-Homebrew-Pull-Request.md
index 2dcb500cef..7c02128625 100644
--- a/docs/How-To-Open-a-Homebrew-Pull-Request.md
+++ b/docs/How-To-Open-a-Homebrew-Pull-Request.md
@@ -34,7 +34,8 @@ The type of change you want to make influences which of Homebrew's main reposito
 
 ### Formulae-related pull request
 
-Before creating a new formulae, please read [Acceptable Formulae](https://github.com/Homebrew/brew/blob/master/docs/Acceptable-Formulae.md).
+Before creating a new formulae, please read [Acceptable Formulae](https://docs.brew.sh/Acceptable-Formulae).
+
 
 1. [Fork the Homebrew/homebrew-core repository on GitHub](https://github.com/Homebrew/homebrew-core/fork).
    * This creates a personal remote repository that you can push to. This is needed because only Homebrew maintainers have push access to the main repositories.
@@ -60,7 +61,8 @@ Before creating a new formulae, please read [Acceptable Formulae](https://github
 
 ### Cask-related pull request
 
-Before creating a new cask, please read [Acceptable Casks](https://github.com/Homebrew/brew/blob/master/docs/Acceptable-Casks.md).
+Before creating a new cask, please read [Acceptable Casks](https://docs.brew.sh/Acceptable-Casks).
+
 1. [Fork the Homebrew/homebrew-cask repository on GitHub](https://github.com/Homebrew/homebrew-cask/fork).
    * This creates a personal remote repository that you can push to. This is needed because only Homebrew maintainers have push access to the main repositories.
 2. Tap (download a local clone of) the repository of core Homebrew casks: