diff --git a/docs/Taps.md b/docs/Taps.md
index 6c1dbb143e..9ed939a0f2 100644
--- a/docs/Taps.md
+++ b/docs/Taps.md
@@ -53,42 +53,28 @@ dunn/emacs
   version: `brew tap username/homebrew-foobar`. `brew` will automatically add
   back the 'homebrew-' prefix whenever it's necessary.
 
-## Formula duplicate names
+## Formula with duplicate names
 
 If your tap contains a formula that is also present in
 [homebrew/core](https://github.com/Homebrew/homebrew-core), that's fine,
 but it means that you must install it explicitly by default.
 
-If you would like to prioritise a tap over `homebrew/core`, you can use
-`brew tap-pin username/repo` to pin the tap,
-and use `brew tap-unpin username/repo` to revert the pin.
-
 Whenever a `brew install foo` command is issued, `brew` will find which formula
 to use by searching in the following order:
 
-* pinned taps
 * core formulae
 * other taps
 
 If you need a formula to be installed from a particular tap, you can use fully
 qualified names to refer to them.
 
-For example, you can create a tap for an alternative `vim` formula. Without
-pinning it, the behaviour will be:
+You can create a tap for an alternative `vim` formula. The behaviour will be:
 
 ```sh
 brew install vim                     # installs from homebrew/core
 brew install username/repo/vim       # installs from your custom repository
 ```
 
-However if you pin the tap with `brew tap-pin username/repo`, you will need to
-use `homebrew/core` to refer to the core formula.
-
-```sh
-brew install vim                     # installs from your custom repository
-brew install homebrew/core/vim       # installs from homebrew/core
-```
-
-Note that pinned taps are prioritized only when the formula name is directly
-given by you, i.e. it will not influence formulae automatically installed as
-dependencies.
+As a result, we recommend you give formulae a different name if you want to make
+them easier to install. Note that there is (intentionally) no way of replacing
+dependencies of core formulae with those from taps.