From bd6fb88ddc72a0de4c27f65e60a82790a5d87f3f Mon Sep 17 00:00:00 2001
From: Mike McQuaid
Date: Mon, 19 Sep 2016 19:58:21 +0100
Subject: Rearrange repository files.

---
 docs/Migrating-A-Formula-To-A-Tap.md | 8 ++++++++
 1 file changed, 8 insertions(+)
 create mode 100644 docs/Migrating-A-Formula-To-A-Tap.md

(limited to 'docs/Migrating-A-Formula-To-A-Tap.md')

diff --git a/docs/Migrating-A-Formula-To-A-Tap.md b/docs/Migrating-A-Formula-To-A-Tap.md
new file mode 100644
index 000000000..7bc984f84
--- /dev/null
+++ b/docs/Migrating-A-Formula-To-A-Tap.md
@@ -0,0 +1,8 @@
+# Migrating A Formula To A Tap
+There are times when we may wish to migrate a formula from one tap into another tap. To do this:
+
+1. Create a pull request to the new tap adding the formula file as-is from the original tap. Fix any test failures that may occur due to the stricter requirements for new formulae than existing formula (e.g. `brew audit --strict` must pass for that formula).
+2. Create a pull request to the original tap deleting the formula file and add it to `tap_migrations.json` with a commit message like `gv: migrating to homebrew/x11`.
+3. Put a link for each pull request in the other pull request so the maintainers can merge them both at once.
+
+Congratulations, you've moved a formula to a tap!
-- 
cgit v1.2.3