Did this work?

idk

Author: amishshah

.gitignore

@@ -36,4 +36,3 @@ build/Release
 node_modules
 test/auth.json
 examples/auth.json
-test/spotify.js

.travis.yml

@@ -2,8 +2,5 @@ language: node_js
 node_js:
   - "stable"
 cache:
-    directories:
-    - node_modules
-branches:
-  only:
-    - master
+directories:
+  - node_modules

.vscode/settings.json

@@ -1,5 +1,2 @@
 // Place your settings in this file to overwrite default and user settings.
-{
-	"editor.wrappingColumn": 0,
-	"editor.formatOnType": true
-}
+{ "editor.wrappingColumn": 0 }

README.md

@@ -4,7 +4,7 @@
   </a>
 </p>
 
-# Did v5.0.0 break your code? [Look here.](http://discordjs.readthedocs.org/en/rewrite-docs/migrating.html)
+# The API is being rewritten for stability, have a look [here](https://github.com/hydrabolt/discord.js/tree/rewrite) for more. It will feature voice!
 
 [![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)
 
@@ -37,11 +37,31 @@ mybot.login("email", "password");
 ```
 ---
 
-### What's new in 5.0.0?
+### What's new in 3.9.0?
 
-Stability in general! The API has been rewritten completely for much better stability, and it seems to have worked! There are now no random crashes and everything caches properly. The API is also a bit cleaner!
+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:
 
-However, it is a breaking change if you are updating (potentially, basic code should be fine) you should look [here](http://discordjs.readthedocs.org/en/rewrite-docs/migrating.html) for help updating.
+```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`
 
 ---
 
@@ -88,4 +108,4 @@ If you have an issue or want to know if a feature exists, [read the documentatio
 
 
 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).
+Or you could just send a DM to **hydrabolt** in [**Discord API**](https://discord.gg/0SBTUU1wZTYd2XyW).

docs/create_simple_bot.rst

@@ -0,0 +1,132 @@
+Creating a Simple Bot
+=====================
+
+This page will walk you through writing a simple bot and will introduce you to some of the most important functions and objects you will encounter in the API.
+
+Setting up a Project
+--------------------
+
+Before you start creating your bot, you need to create a directory, for example *discordbot*.
+
+After you've done that, open up the directory and have a look at how to `install the module`_. After you've installed the module, you can progress to the next step
+
+Creating the Bot
+----------------
+
+Now we can begin writing the bot. This bot will just server the user their avatar but at a higher resolution - assuming they have one.
+
+Firstly, create a file named ``bot.js`` in the directory you made earlier. Open it up, and type the following lines of code:
+
+.. code-block:: js
+
+    var Discord = require("discord.js");
+    var bot = new Discord.Client();
+
+This code firstly imports the discord.js module, which contains classes to help you create clients for Discord. The second line creates a new Discord Client, which we can manipulate later. Now, we want the client to be alerted when there is a new message and do something, so we can type this:
+
+.. code-block:: js
+
+    bot.on("message", function(message){
+
+    } )
+
+This will simply get our client to listen out for new messages, but not yet do anything. Let's have a look at this:
+
+.. code-block:: js
+
+    bot.on("message", function(message){
+        
+		if( message.content === "avatar me!" ){
+		
+		}
+		
+    } )
+
+This code will now get our client to execute anything inside the if statement as long as the message sent was "avatar me!" We can now get it to see if the user has an avatar:
+
+.. code-block:: js
+
+    bot.on("message", function(message){
+        
+		if( message.content === "avatar me!" ){
+		    
+            var usersAvatar = message.sender.avatarURL;
+            
+            if(usersAvatar){
+                // user has an avatar
+            }else{
+                // user doesn't have an avatar
+            }
+            
+		}
+		
+    } )
+    
+This code will now see if the user has an avatar and then do something based on that, let's finalise it:
+
+.. code-block:: js
+
+    bot.on("message", function(message){
+        
+		if( message.content === "avatar me!" ){
+		    
+            var usersAvatar = message.sender.avatarURL;
+            
+            if(usersAvatar){
+                // user has an avatar
+                
+                bot.reply(message, "your avatar can be found at " + usersAvatar);
+                
+            }else{
+                // user doesn't have an avatar
+                
+                bot.reply(message, "you don't have an avatar!");
+            }
+            
+		}
+		
+    } )
+    
+Let's have a look at the function we used here; *bot.reply*. This function takes 2 necessary parameters, a message object to reply to and a message to send. The first parameter we already have, and it is the message we have received. The second parameter is what we want to send.
+
+Now that we've finished the listener event, we need to log the client in:
+
+.. code-block:: js
+
+    bot.login("your discord email", "your discord password");
+    
+And that's it! Run the code with ``node bot.js`` and wait a few seconds, and then try sending *avatar me!* to any of the channels that the user you provided has details to.
+    
+Final Product
+-------------
+.. code-block:: js
+
+    var Discord = require("discord.js");
+    var bot = new Discord.Client();
+    
+    bot.on("message", function(message){
+        
+		if( message.content === "avatar me!" ){
+		    
+            var usersAvatar = message.sender.avatarURL;
+            
+            if(usersAvatar){
+                // user has an avatar
+                
+                bot.reply(message, "your avatar can be found at " + usersAvatar);
+                
+            }else{
+                // user doesn't have an avatar
+                
+                bot.reply(message, "you don't have an avatar!");
+            }
+            
+		}
+		
+    } );
+    
+    bot.login("your discord email", "your discord password");
+    
+.. note:: This page is still a WIP, check back later for more documentation on it.
+
+.. _install the module : http://discordjs.readthedocs.org/en/latest/get_started.html#installation

docs/docs_cache.rst

@@ -1,23 +1,82 @@
-.. include:: ./vars.rst
-
-Channel
-=======
-
-**extends** Equality_
-
-The Channel class is the base class for all types of channel.
-
-Attributes
-----------
-
---------
-
-id
-~~
-
-The ID of the channel, a `String`.
-
-client
-~~~~~~
-
-The Client_ that cached the channel.
+.. include:: ./vars.rst
+
+Channels
+========
+
+The Channel Class is used to represent data about a Channel.
+
+Attributes
+----------
+
+client
+~~~~~~
+
+The Discord Client_ that cached the channel
+
+server
+~~~~~~
+
+The Server_ that the channel belongs to
+
+name
+~~~~
+
+The channel's name, as a `String`.
+
+id
+~~
+
+The channel's id, as a `String`.
+
+type
+~~~~
+
+The type of the channel as a `String`, either ``text`` or ``voice``.
+
+topic
+~~~~~
+
+A `String` that is the topic of the channel, if the channel doesn't have a topic this will be `null`.
+
+messages
+~~~~~~~~
+
+An `Array` of Message_ objects received from the channel. There are up to a 1000 messages here, and the older messages will be deleted if necessary.
+
+members
+~~~~~~~
+
+**Aliases** : `users`
+
+The members in the channel's server, an `Array` of User_ objects.
+
+-----
+
+Functions
+---------
+
+.. note:: When concatenated with a String, the object will become the channel's embed code, e.g. ``"this is " + channel`` would be ``this is <#channelid>``
+
+getMessage(key, value)
+~~~~~~~~~~~~~~~~~~~~~~
+
+Gets a Message_ from the channel that matches the specified criteria. E.g:
+
+.. code-block:: js
+
+    channel.getMessage("id", 1243987349) // returns a Message where message.id === 1243987349
+    
+- **key** - a `String` that is the key
+- **value** - a `String` that is the value
+
+permissionsOf(user)
+~~~~~~~~~~~~~~~~~~~
+
+Gets the EvaluatedPermissions_ of a User in the channel.
+
+- **user** - A User_ or Member_ you want to get the permissions of.
+
+equals(object)
+~~~~~~~~~~~~~~
+
+Returns a `Boolean` depending on whether the Channel's ID (``channel.id``) equals the object's ID (``object.id``). You should **always**, always use this if you want to compare channels. **NEVER** do ``channel1 == channel2``.