diff --git a/README.md b/README.md
new file mode 100644
index 00000000000..549c579d6e8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# Homebrew Core
+Core formulae for the Homebrew package manager.
+
+## How do I install these formulae?
+Just `brew install <formula>`. This is the default tap of Homebrew.
+
+## Troubleshooting
+First, please run `brew update` and `brew doctor`.
+
+Second, read the [Troubleshooting Checklist](https://github.com/Homebrew/homebrew/blob/master/share/doc/homebrew/Troubleshooting.md#troubleshooting).
+
+**If you don’t read these it will take us far longer to help you with your problem.**
+
+## Documentation
+`brew help`, `man brew` or check [Homebrew's documentation](https://github.com/Homebrew/homebrew/tree/master/share/doc/homebrew#readme).
+
+## License
+Code is under the [BSD 2 Clause (NetBSD) license](https://github.com/Homebrew/homebrew-core/blob/master/LICENSE.txt).