-Phabricator is an open source collection of web applications which help
-software companies build better software.
-
-Phabricator includes applications for:
-
- - reviewing and auditing source code;
- - hosting and browsing repositories;
- - assembling a party to venture forth;
- - tracking bugs;
- - hiding stuff from coworkers; and
- - also some other things.
-
-You can learn more about the project (and find links to documentation and
-resources) [[http://phabricator.org/ | here]].
-
-Phabricator is developed and maintained by [[http://phacility.com/ |
-Phacility]]. The first version of Phabricator was originally built at Facebook.
-
-= LICENSE =
-Phabricator is released under the Apache 2.0 license except as otherwise noted.
diff --git a/README.md b/README.md
new file mode 100644
--- /dev/null
+++ b/README.md
@@ -0,0 +1,31 @@
+**Phabricator** is an open source collection of web applications which help software companies build better software.
+
+Phabricator includes applications for:
+
+ - reviewing and auditing source code;
+ - hosting and browsing repositories;
+ - assembling a party to venture forth;
+ - tracking bugs;
+ - managing projects;
+ - writing stuff down and reading it later;
+ - hiding stuff from coworkers; and
+ - also some other things.
+
+You can learn more about the project (and find links to documentation and resources) at [Phabricator.org](http://phabricator.org)
+
+Phabricator is developed and maintained by [Phacility](http://phacility.com). The first version of Phabricator was originally built at Facebook.
+
+**BUG REPORTS**
+Please update your install to HEAD before filing bug reports. You can follow our [bug reporting guide](https://secure.phabricator.com/book/phabcontrib/article/bug_reports/) or and file the issue in [Maniphest](https://secure.phabricator.com/maniphest/task/create/).
+
+**FEATURE REQUESTS**
+We're big fans of feature requests that state core problems, not just 'add this'. We've compiled a short guide to effective upstream requests [here](https://secure.phabricator.com/book/phabcontrib/article/feature_requests/).
+
+**SECURITY ISSUES**
+Phabricator participates in HackerOne and may pay out for various issues reported there. You can find out more information on our [HackerOne page](https://hackerone.com/phabricator).
+
+**PULL REQUESTS**
+We do not accept pull requests through GitHub. If you would like to contribute code, please read our [Contributor's Guide](https://secure.phabricator.com/book/phabcontrib/article/contributing_code/) for more information.
+
+**LICENSE**
+Phabricator is released under the Apache 2.0 license except as otherwise noted.