diff --git a/README.md b/README.md
index 94d4564f5..493b2300b 100644
--- a/README.md
+++ b/README.md
@@ -4,106 +4,24 @@
   </a>
 </p>
 
-[![Build Status](https://travis-ci.org/hydrabolt/discord.js.svg)](https://travis-ci.org/hydrabolt/discord.js) [![Documentation Status](https://readthedocs.org/projects/discordjs/badge/?version=latest)](http://discordjs.readthedocs.org/en/latest/?badge=latest)
-    
+## Welcome to the rewrite branch!
 
-discord.js is a node module used as a way of interfacing with
-[Discord](https://discordapp.com/). It is a very useful module for creating
-bots.
+The rewrite branch was created as a way of completely rewriting the API (once again) for complete stability. Versions <= 4.1.1 of the API would _always_ eventually crash for one reason or another.
 
-**The examples in the repo are in ES6, either update your node or compile them down to babel yourself if you want to use them!**
+So far, the rewrite branch seems to have achieved what was wanted, as it is much more stable and can handle mass joining and leaving of servers. Users, channels and servers are always cached properly, and the only time of expected crashes are when an error occurs in the WebSocket.
 
-### Installation
-`npm install --save discord.js`
-
----
-
-### Example
-```js
-var Discord = require("discord.js");
-
-var mybot = new Discord.Client();
-
-mybot.on("message", function(message){
-	
-	if(message.content === "ping")
-		mybot.reply(message, "pong");
-	
-});
-
-mybot.login("email", "password");
-```
----
-
-### What's new in 3.9.0?
-
-Amongst some fixes to web distribution creation, you can now opt for easier string formatting! However, it does modify String globally so you'll have to run:
+You can start using the rewrite branch, but it is a breaking change. The documentation isn't done, but H
+here is the main notable change:
 
 ```js
-Discord.patchStrings()
-```
-
-After you have run this, you can do:
-```
-
-"message".bold.underline.italic
-// generates "*__**message**__*"
-
-```
-
-A full list of modifiers (all chainable):
-
-* bold `**`
-* italic `*`
-* underline `__`
-* strike `~`
-* code `` ` ``
-* codeblock ```` ``` ````
-* newline `\n`
-
----
-
-### Related Projects
-
-Here is a list of other Discord APIs:
-
-#### Java:
-[Discord4J](https://github.com/nerd/Discord4J)
-#### .NET:
-[Discord.Net](https://github.com/RogueException/Discord.Net)
-
-[DiscordSharp](https://github.com/Luigifan/DiscordSharp)
-#### NodeJS
-[discord.io](https://github.com/izy521/node-discord) (similar to discord.js but lower level)
-
-#### PHP
-[DiscordPHP](https://github.com/teamreflex/DiscordPHP)
-
-#### Python
-[discord.py](https://github.com/Rapptz/discord.py)
-
-#### Ruby
-[discordrb](https://github.com/meew0/discordrb)
-
----
-
-### Links
-**[Documentation](http://discordjs.readthedocs.org/en/latest/)**
-
-**[GitHub](https://github.com/discord-js/discord.js)**
-
-**[Wiki](https://github.com/discord-js/discord.js/wiki)**
-
-**[Website](http://discord-js.github.io/)**
-
-**[NPM](npmjs.com/package/discord.js)**
-
----
-
-### Contact
-
-If you have an issue or want to know if a feature exists, [read the documentation](http://discordjs.readthedocs.org/en/latest/) before contacting me about any issues! If it's badly/wrongly implemented, let me know!
-
-
-If you would like to contact me, you can create an issue on the GitHub repo, e-mail me via the one available on my NPM profile.
-Or you could just send a DM to **hydrabolt** in [**Discord API**](https://discord.gg/0SBTUU1wZTYd2XyW).
+// old method:
+client.getUser("id", 12);
+client.getChannel("id", 12);
+client.getServer("id", 12);
+	// etc...
+	
+// new method:
+client.users.get("id", 12);
+client.channels.get("id", 12);
+client.servers.get("id", 12);
+```
\ No newline at end of file