diff --git a/docs/examples/Avatars.js b/docs/examples/Avatars.js
new file mode 100644
index 000000000..796d942bd
--- /dev/null
+++ b/docs/examples/Avatars.js
@@ -0,0 +1,30 @@
+/*
+  Send a user a link to their avatar
+*/
+
+// import the discord.js module
+const Discord = require('discord.js');
+
+// create an instance of a Discord Client, and call it bot
+const bot = new Discord.Client();
+
+// the token of your bot - https://discordapp.com/developers/applications/me
+const token = 'your bot token here';
+
+// the ready event is vital, it means that your bot will only start reacting to information
+// from Discord _after_ ready is emitted.
+bot.on('ready', () => {
+  console.log('I am ready!');
+});
+
+// create an event listener for messages
+bot.on('message', message => {
+  // if the message is "what is my avatar",
+  if (message.content === 'what is my avatar') {
+    // send the user's avatar URL
+    message.reply(message.author.avatarURL);
+  }
+});
+
+// log our bot in
+bot.login(token);
diff --git a/docs/examples/Ping-pong.js b/docs/examples/Ping-pong.js
new file mode 100644
index 000000000..4cede6a80
--- /dev/null
+++ b/docs/examples/Ping-pong.js
@@ -0,0 +1,30 @@
+/*
+  A ping pong bot, whenever you send "ping", it replies "pong".
+*/
+
+// import the discord.js module
+const Discord = require('discord.js');
+
+// create an instance of a Discord Client, and call it bot
+const bot = new Discord.Client();
+
+// the token of your bot - https://discordapp.com/developers/applications/me
+const token = 'your bot token here';
+
+// the ready event is vital, it means that your bot will only start reacting to information
+// from Discord _after_ ready is emitted.
+bot.on('ready', () => {
+  console.log('I am ready!');
+});
+
+// create an event listener for messages
+bot.on('message', message => {
+  // if the message is "ping",
+  if (message.content === 'ping') {
+    // send "pong" to the same channel.
+    message.channel.sendMessage('pong');
+  }
+});
+
+// log our bot in
+bot.login(token);