GitHub renders reStructuredText on README.rst files, making the repo …

…front page prettier on GitHub.

README.rst

@@ -0,0 +1,52 @@
+.. contents::
+
+Introduction
+============
+
+Zope2 is an open-source web application server.
+
+This document provides some general information about Zope2 and provides
+links to other documents.
+
+Installation information can be found in ``doc/INSTALL.rst``.  Other
+documentation is also in the "doc" directory and in the zope.org
+documentation section at http://docs.zope.org/ .
+
+General Zope information is available at http://www.zope.org/
+
+Installation
+============
+
+Follow the instructions in ``doc/INSTALL.rst`` to install Zope.
+
+If you do not have a source checkout with docs, you can find the latest
+install docs online at https://github.com/zopefoundation/Zope/blob/master/doc/INSTALL.rst
+
+Note that you *cannot* simply do ``easy_install zope2`` or
+``pip install zope2``, because you need specific versions of all
+dependencies. Follow the documentation to ensure you get the correct
+versions, or else installation is very likely to fail.
+
+License
+=======
+
+The Zope License is included in ``ZopePublicLicense.txt``.  Send your
+feedback about the license to zope-dev@zope.org.
+
+Bug tracker
+===========
+
+Bugs reports should be made through the Zope bugtracker at
+https://bugs.launchpad.net/zope2.  A bug report should contain detailed
+information about how to reproduce the bug, error messages (see
+``/error_log`` within the ZMI or ``var/event.log``).
+
+Mailing list
+============
+
+You can contact and discuss Zope2 on the Zope mailing list (zope@zope.org).
+To subscribe to the list send mail to zope-request@zope.org with ``subscribe``
+in the subject line.
+
+You can also subscribe online from here:
+http://mail.zope.org/mailman/listinfo/zope