Squashed commit of the following:

commit 7f65954
Author: Tod Beardsley <[email protected]>
Date:   Mon Dec 1 07:54:53 2014 -0600

    Add a pointer to true and correct docs

    See rapid7#4000. Seems kind of pointless to ship all these bytes when we host
    everything on GitHub and provide tools to generate docs yourself.

commit 01668c8
Author: Tod Beardsley <[email protected]>
Date:   Mon Dec 1 07:39:11 2014 -0600

    Remove old documentation

    The last significant commit in this directory was a844b5c , which
    touched a sample browser module. Before that, changes were either
    ranging across the codebase, or surgical removal of out of date
    documentation.

    This all is looking to me like fairly useless historical artifacts.

    See rapid7#4000 for more discussion.

Author: Tod Beardsley

documentation/README.md

@@ -0,0 +1,34 @@
+# Metasploit Developer Documentation
+
+*(last updated December 1, 2014)
+
+Metasploit is actively supported by a community of hundreds of
+contributors and thousands of users world-wide. As a result, the
+accompanying documentation moves quite quickly.
+
+The best source of documentation on Metasploit development is
+https://github.com/rapid7/metasploit-framework/wiki. There are many
+treasures there, such as:
+
+  * [Evading Antivirus](https://github.com/rapid7/metasploit-framework/wiki/Evading-Anti-Virus)
+  * [How Payloads Work](https://github.com/rapid7/metasploit-framework/wiki/How-payloads-work)
+  * [How to use Datastore Options](https://github.com/rapid7/metasploit-framework/wiki/How-to-use-datastore-options)
+  * [How to write browser exploits with BES](https://github.com/rapid7/metasploit-framework/wiki/How-to-write-a-browser-exploit-using-BrowserExploitServer)
+  * [How to write a bruteforcer](https://github.com/rapid7/metasploit-framework/wiki/How-to-use-Msf%3A%3AAuxiliary%3A%3AAuthBrute-to-write-a-bruteforcer)
+
+...and many, many more.
+
+## API Documentation
+
+If you are looking for API documentation, you may run `rake yard` to
+generate a navigatable view of the comment documentation used throughout
+Metasploit, or visit https://rapid7.github.io/metasploit-framework/api
+for a recently generated online version.
+
+## Contributing
+
+If you would like to contribute to the documentation effort, please see
+http://yardoc.org/ for details on how to write YARD-compatible comments,
+and send us a [Pull Request](https://github.com/rapid7/metasploit-framework/pulls)
+with your contribution.
+