Re-work the changelog

Rewrite the changelog to use consistent formatting and structure.

Different releases would have different section headers
(e.g. Added / Changed) rather than the newer headers
(Added / Fixed / Changed / Misc.). Convert all of the old releases to
use the newer, 4-section style.

Additionally, anchor commits for all list items, and put all of the
commit anchors at the bottom of the document. Anchors unique to a
release are now at the bottom of that release.

1 files changed, 335 insertions, 186 deletions

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2c1dd74..5064675 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -66,21 +66,6 @@ channel_id.get_reaction_users(message_id, reaction_type, Some(10), None);
 - Make `GLOBAL` ratelimit mutex a unit (opt.) [c:55ccaca]
 - Resume when restarting WS sender/receiver [c:04cfaa9]
 
-[c:04cfaa9]: https://github.com/zeyla/serenity/commit/04cfaa9a69dc1638e9cd1904a9b8e94c1a97f832
-[c:0b9bf91]: https://github.com/zeyla/serenity/commit/0b9bf91f62eef85a4eca703902077f4c04b3b6d1
-[c:268f356]: https://github.com/zeyla/serenity/commit/268f356a25f27175a5d72458fff92b0f770d0a5a
-[c:4cf8338]: https://github.com/zeyla/serenity/commit/4cf8338e364b0feefef26ece6649077e87962ff3
-[c:55ccaca]: https://github.com/zeyla/serenity/commit/55ccaca57051b3fbd47cf7fa288014d9c36f6952
-[c:5ee5fef]: https://github.com/zeyla/serenity/commit/5ee5feff615565b6f661ee3598fe19bb98bd6a88
-[c:6f33a35]: https://github.com/zeyla/serenity/commit/6f33a35c4f85a06c45c4ce9e118db203c4951475
-[c:9392f61]: https://github.com/zeyla/serenity/commit/9392f61f8857b6ab2a04781c2d9c92a582a1577b
-[c:97f9bd1]: https://github.com/zeyla/serenity/commit/97f9bd10c16eb24d54a0ab00c52f19eb51a88675
-[c:b7cbf75]: https://github.com/zeyla/serenity/commit/b7cbf75103939b0b7834c808050b19ba4fbc4b17
-[c:c8c6b83]: https://github.com/zeyla/serenity/commit/c8c6b83ca685a3e503c853d4154a17761790954e
-[c:e891ebe]: https://github.com/zeyla/serenity/commit/e891ebeba43eb87c985db4e031b8bf76dcaca67b
-[c:eb09f2d]: https://github.com/zeyla/serenity/commit/eb09f2d3389b135978e0671a0e7e4ed299014f94
-[c:f00e165]: https://github.com/zeyla/serenity/commit/f00e1654e8549ec6582c6f3a8fc4af6aadd56015
-
 
 ## [0.1.4] - 2017-01-26
 
@@ -109,6 +94,141 @@ Two of the major highlights of this release are that the broken pipe issue has
 been fixed, and the library is more OOP now and therefore no longer relies on
 the `Context` to get stuff done. The `methods` feature flag has been removed.
 
+### Upgrade Path
+
+When formatting using `Display` for `ChannelId`s, `RoleId`s, and `UserId`,
+instead of formatting use their `Mentionable` equivilants:
+
+```rust
+use serenity::model::{ChannelId, RoleId, UserId};
+
+// old
+assert_eq!(format!("{}", ChannelId(1)), "<#1>");
+assert_eq!(format!("{}", RoleId(2)), "<@&2>");
+assert_eq!(format!("{}", UserId(3)), "<@3>");
+
+// new
+assert_eq!(format!("{}", ChannelId(1).mention()), "<#1>");
+assert_eq!(format!("{}", RoleId(2)).mention()), "<@&2>");
+assert_eq!(format!("{}", UserId(3).mention()), "<@3>");
+```
+
+When using `EmbedBuilder::{image, thumbnail}`, instead of calling another
+builder, provide `url`s directly:
+
+```rust
+use serenity::model::Embed;
+
+// old
+Embed::fake(|e| e
+    .image(|i| i.url("https://not.zey.moe/me.png"))
+    .thumbnail(|t| t.url("https://not.zey.moe/me2.png")));
+
+// new
+Embed::fake(|e| e
+    .image("https://not.zey.moe/me.png")
+    .thumbnail("https://not.zey.moe/me2.png"));
+```
+
+When specifying a sharding method, instead of passing a `u8` for sharding info,
+pass a `u64`:
+
+```rust
+use serenity::Client;
+
+let client = Client::login_bot(&env::var("DISCORD_TOKEN").unwrap());
+
+// old
+client.start_shard(1u8, 5u8); // or
+client.start_shards(5u8); // or
+client.start_shard_range([1u8, 3u8], 8u8);
+
+// new
+client.start_shard(1u64, 5u64); // or
+client.start_shards(5u64); // or
+client.start_shard_range([1u64, 3u64], 8u64);
+```
+
+`Client.shards` is now private. Instead of accessing it, don't.
+
+When creating a `Colour` struct yourself, instead of specifying a single `value`
+field, pass a single tuple value:
+
+```rust
+use serenity::utils::Colour;
+
+// old
+Colour {
+    value: 0,
+}
+
+// new
+Colour(0);
+```
+
+Instead of using `Attachment::download_to_directory` to download an attachment
+to a directory, do it yourself:
+
+```rust
+use std::fs::File;
+use std::io::Write;
+
+// assuming an `attachment` has already been bound
+
+// old
+attachment.download_to_directory("./attachments");
+
+// new
+let bytes = attachment.download().unwrap();
+let filepath: PathBuf = path.as_ref().join(&attachment.filename);
+let mut f = File::create(&filepath);
+let _ = f.write(&bytes);
+```
+
+Instead of calling `Message::is_webhook()`:
+
+```rust
+// assuming a `message` has already been bound
+
+// old
+let _ = message.is_webhook();
+
+// new
+let _ = message.webhook_id.is_some();
+```
+
+Instead of `PartialGuild::find_role(role_id)`:
+
+```rust
+use serenity::model::RoleId;
+
+// assuming a `guild` has already been bound
+
+// old
+let _ = guild.find_role(RoleId(1));
+
+// new
+let _ = guild.roles.get(RoleId(1));
+```
+
+Instead of `Guild::{get_channel, get_member}`, call:
+
+```rust
+use serenity::model::{ChannelId, UserId};
+
+// assuming a `guild` has already been bound
+
+// old
+let _ = guild.get_channel(ChannelId(1));
+let _ = guild.get_member(UserId(2));
+
+// new
+let _ = guild.channels.get(ChannelId(1));
+let _ = guild.members.get(UserId(2));
+```
+
+Instead of using `Context` methods, use their `Id` or other struct equivalents.
+
 ### Added
 
 - the `voice` feature no longer requires the `cache` feature to be enabled
@@ -211,90 +331,37 @@ the `Context` to get stuff done. The `methods` feature flag has been removed.
 - Avoid a needless string clone on login [c:d3389be]
 - Avoid a lot of `Arc`/`Message`/`RwLock` clones [c:8c5ee70]
 
-[c:00fb61b]: https://github.com/zeyla/serenity/commit/00fb61b5f306aebde767cc21a498a8ca0742d0be
-[c:0708ccf]: https://github.com/zeyla/serenity/commit/0708ccf85bac347e59053133a2b8b6f2eabe99ba
-[c:096b0f5]: https://github.com/zeyla/serenity/commit/096b0f57aae04a5e0ea28414f5016eeafc5b9e0a
-[c:0a2f5ab]: https://github.com/zeyla/serenity/commit/0a2f5ab525022fbf0055649f2262573fb07cf18c
-[c:147cf01]: https://github.com/zeyla/serenity/commit/147cf01d4f13e3ee15eb03705ab2b7a006851cdd
-[c:1594961]: https://github.com/zeyla/serenity/commit/159496188b2c841a65829328cddafef620c517af
-[c:2416813]: https://github.com/zeyla/serenity/commit/24168137ff7b1ec44d3ecdec0f516455fd3785a7
-[c:2a743ce]: https://github.com/zeyla/serenity/commit/2a743cedaf08f7eb532e3c4b795cfc5f85bc96af
-[c:2b237e7]: https://github.com/zeyla/serenity/commit/2b237e7de221beab9c516d6de29f83188ef63840
-[c:2cb607d]: https://github.com/zeyla/serenity/commit/2cb607d72a39aa7ab3df866b23de4c9798e69a0f
-[c:3348178]: https://github.com/zeyla/serenity/commit/3348178f151d8e1d7aa0432984a2dd23fa7b9e89
-[c:345e140]: https://github.com/zeyla/serenity/commit/345e1401142d21a0fdabb2accd1f33e3a07c02c8
-[c:38a484d]: https://github.com/zeyla/serenity/commit/38a484d0fec91e290bc1633fc871131f9decd0ca
-[c:38db32e]: https://github.com/zeyla/serenity/commit/38db32e2cbb9dc8504e0dfbc2366b17596836da0
-[c:3ca7ad9]: https://github.com/zeyla/serenity/commit/3ca7ad92507f056054d081485f437c08505bc7e5
-[c:4229034]: https://github.com/zeyla/serenity/commit/42290348bc05c876b7e70c570a485160e594e098
-[c:5918d01]: https://github.com/zeyla/serenity/commit/5918d01ed69541e43aed0e62ee6eadbf5ebb20d2
-[c:5b275fc]: https://github.com/zeyla/serenity/commit/5b275fc425d4ef1c1a9eaa9d915db1f873f9c11d
-[c:5c40e85]: https://github.com/zeyla/serenity/commit/5c40e85001b9b2620a76fcc57d8f0cddfb6f9b34
-[c:5fe6a39]: https://github.com/zeyla/serenity/commit/5fe6a3956d39e9b5caef19df78e8b392898b6908
-[c:6a887b2]: https://github.com/zeyla/serenity/commit/6a887b25f2712d70c65fc85b5cfbd8b6d4b41260
-[c:6355288]: https://github.com/zeyla/serenity/commit/635528875c59d34f0d7b2f2b0a3bd61d762f0e9c
-[c:651c618]: https://github.com/zeyla/serenity/commit/651c618f17cb92d3ea9bbd1d5f5c92a015ff64e0
-[c:66546d3]: https://github.com/zeyla/serenity/commit/66546d36749f6c78a4957a616524fab734d5c972
-[c:68c473d]: https://github.com/zeyla/serenity/commit/68c473dd17a2098f97808b3d1f2a200621f67c9d
-[c:69ec62a]: https://github.com/zeyla/serenity/commit/69ec62a42bcb143cdde056ad8ffce81922e88317
-[c:70bf22a]: https://github.com/zeyla/serenity/commit/70bf22a00cd19651a0d994cc43e8d8c4bd8947fc
-[c:760a47a]: https://github.com/zeyla/serenity/commit/760a47aa4d34160f44048e775afeb30f08891c99
-[c:76f9095]: https://github.com/zeyla/serenity/commit/76f9095c012a8769c7bd27aca6540b7018574c28
-[c:7b45f16]: https://github.com/zeyla/serenity/commit/7b45f16f063a47dc8a302dce5b016cf43a3edcc1
-[c:83b29d5]: https://github.com/zeyla/serenity/commit/83b29d5f839cd2ea6cd150aa7b8ccbbc677c1fad
-[c:86cd00f]: https://github.com/zeyla/serenity/commit/86cd00f20d6f218e524deed040d3c209f0361a86
-[c:8c5ee70]: https://github.com/zeyla/serenity/commit/8c5ee70b28b42ac92f899932ab2ddafeb9c6f913
-[c:8e2c052]: https://github.com/zeyla/serenity/commit/8e2c052a55e5e08c6e7ed643b399f1a7f69a2b25
-[c:92309b2]: https://github.com/zeyla/serenity/commit/92309b2fb8ffd96292fd2edaa7c223a2ba774a56
-[c:933ee89]: https://github.com/zeyla/serenity/commit/933ee8914509e52c5119ced9f5d9d8f9644cfa63
-[c:93f3c60]: https://github.com/zeyla/serenity/commit/93f3c60b23cb8ffd16666bdc01b3502ca7ba5f47
-[c:a2cbeb6]: https://github.com/zeyla/serenity/commit/a2cbeb6ece9ef56e2082b6eabbabe5fe536ab3ec
-[c:a8acd61]: https://github.com/zeyla/serenity/commit/a8acd6138741a6e5268141ac4ce902561931d353
-[c:ab778f8]: https://github.com/zeyla/serenity/commit/ab778f8a9cf47c4e27fe688a61effb0caa4f8a6e
-[c:ada07fa]: https://github.com/zeyla/serenity/commit/ada07fae09f3521f44d81613f26839d69c1fc7ef
-[c:abd22d2]: https://github.com/zeyla/serenity/commit/abd22d289599530cbd1bc9cf1b739420f0d22372
-[c:b001234]: https://github.com/zeyla/serenity/commit/b0012349cca2a5c7c62bb6d2c99106d245b6c55a
-[c:bcb70e8]: https://github.com/zeyla/serenity/commit/bcb70e85384a16b2440788a73241f507aaeba4dc
-[c:c01f238]: https://github.com/zeyla/serenity/commit/c01f238a34ad846f8732c8bf97fbbd96fbf6a7ae
-[c:c050c59]: https://github.com/zeyla/serenity/commit/c050c59da25b9093a75bda22baa81be3b267c688
-[c:c2e8b69]: https://github.com/zeyla/serenity/commit/c2e8b69702cf81a1cf149c420aec999124f398e2
-[c:c36841d]: https://github.com/zeyla/serenity/commit/c36841dd1c3f80141251ba01130333f43ff363d7
-[c:d3389be]: https://github.com/zeyla/serenity/commit/d3389be3042fd7977350a08152d177ac6cdcd37f
-[c:d58c544]: https://github.com/zeyla/serenity/commit/d58c54425a18bbbdc8e66e8eebfb8191bad06901
-[c:e5a83dd]: https://github.com/zeyla/serenity/commit/e5a83dd1873e5af2df18835d960fe19286c70f1e
-[c:e85e901]: https://github.com/zeyla/serenity/commit/e85e901062e8b9ea717ec6c6253c9c7a300448d3
-[c:e8a9086]: https://github.com/zeyla/serenity/commit/e8a90860d1e451e21d3bf728178957fe54cf106d
-[c:e9aae9c]: https://github.com/zeyla/serenity/commit/e9aae9c043b206b15bd5429126ded62259d6731b
-[c:f3f74ce]: https://github.com/zeyla/serenity/commit/f3f74ce43f8429c4c9e38ab7b905fb5a24432fd4
-[c:f57a187]: https://github.com/zeyla/serenity/commit/f57a187d564bdcd77f568e77a102d6d261832ee0
-[c:f894cfd]: https://github.com/zeyla/serenity/commit/f894cfdc43a708f457273e1afb57ed1c6e8ebc58
-[c:f96b6cc]: https://github.com/zeyla/serenity/commit/f96b6cc5e1e0383fd2de826c8ffd95565d5ca4fb
-[c:fafa363]: https://github.com/zeyla/serenity/commit/fafa3637e760f0c72ae5793127bc2f70dcf2d0e2
-[c:fb07751]: https://github.com/zeyla/serenity/commit/fb07751cfc1efb657cba7005c38ed5ec6b192b4f
-[c:fb4d411]: https://github.com/zeyla/serenity/commit/fb4d411054fa44928b4fa052b19de19fce69d7cf
-
 
 ## [0.1.3] - 2016-12-14
 
 This is a hotfix for applying a PR and fixing a major bug in the plain help
 command.
 
+Thanks to the following for contributions this release:
+
+- [@fwrs]
+
+### Upgrade Path
+
+None.
+
 ### Added
 
-- Blocking individual users and guilds in commands
-- Disabling commands
-- Configuring "owners" of the bot, which command checks won't apply to
+- Blocking individual users and guilds in commands, add blocking commands, and
+  configuring owners of bots ([@fwrs]) [c:a39647d]
 
 ### Fixed
 
 - The plain help command now properly sends a message when requesting
-  information about a command
-- Groups are now on their own lines in the plain help command
+  information about a command [c:7b4b154]
+
+### Misc.
 
+- Groups are now on their own lines in the plain help command [c:16bd765]
 
 ## [0.1.2] - 2016-12-14
 
-v0.1.2 focuses on revamping the framework, adding a large amount of
+This release focuses on revamping the framework, adding a large amount of
 configuration and overall features. v0.1.3 will be focused on performance
 optimizations and code cleanup.
 
@@ -305,92 +372,49 @@ Thanks to the following for contributions this release:
 
 v0.1.2 can now be retrieved from the [crates.io listing].
 
-### Added
-
-`UserId::find()` has been added to find the User from cache ([@fwrs]).
-
-`utils::{parse_channel, parse_emoji, parse_role, parse_username}` added to parse
-each item from a string; useful for command arguments.
-
-The `CreateEmbed` builder now implements `From<Embed>`, so you can use an
-  already-built embed from something like a `Message`.
-
-`Context::get_current_user` to retrieve the current user from the cache; prefer
-using `CACHE.read().unwrap().user` to avoid a clone.
-
-Implemented `Emoji::url()` and `EmojiIdentifier::url()` to generate URLs for the
-emoji's image.
-
-The framework has been revamped:
-Structs can now be used as framework command arguments. FromStr is implemented
-for:
-- `User`
-- `UserId`
-- `Role`
-- `RoleId`
-- `EmojiIdentifier`
-- `ChannelId`
-- `Channel`
-You can implement this yourself for your own structs ([@fwrs]).
-
-The framework global configuration now has additional configuration:
-
-- account type to listen to or ignore (selfbot, ignore bots, or listen to
-  everyone)
-- dynamic prefix per context
-- multiple prefixes
-- error messages for various errors (not enough arguments, command cooldown,
-  check fails, lack of permissions, etc.)
-
-Commands can now be built with a large amount of configuration via a
-`CreateCommand` builder; see example 06 on how to use this. The configuration
-for commands includes:
+### Upgrade Path
 
-- checks (whether the command should be executed)
-- cooldown (ratelimit) bucket
-- description (used for the help command)
-- usage listing (used for the help command)
-- argument quote parsing (parsing `a b c` vs. `a "b c"`)
-- required minimum/maximum argument counts
-- permissions required to use the command
-- whether to display the command in the help message
-- whether the command can only be used in DMs or Guilds
+When using `EmbedBuilder::{image, thumbnail}`, instead of calling another
+builder, provide `url`s directly:
 
-Additionally, groups can now be created via the `CreateGroup` builder. It allows
-setting the group name (e.g. `"music"`), adding commands to the group, and
-setting the group's prefix.
+```rust
+use serenity::model::Embed;
 
-Two default help commands are provided for you if you don't wish to make your
-own: one that creates an embed and one that is text-only.
+// old
+Embed::fake(|e| e
+    .image(|i| i.url("https://not.zey.moe/me.png"))
+    .thumbnail(|t| t.url("https://not.zey.moe/me2.png")));
 
+// new
+Embed::fake(|e| e
+    .image("https://not.zey.moe/me.png")
+    .thumbnail("https://not.zey.moe/me2.png"));
+```
 
-Thanks to [@fwrs] for most work of the work on the framework.
+### Added
 
-See [example 06][v0.1.2:example 06] for examples on most of this.
+- Allow mentionable structs to be used as command arguments ([@fwrs])
+  [c:626ffb2]
+- Implemented `From<Embed> for CreateEmbed` [c:7914274]
+- Framework command builder, quoted arguments, multi-prefixes ([@fwrs])
+  [c:8f24aa3]
+- `{Emoji,EmojiIdentifier}::url` [c:ef6eba3]
+- Command groups and buckets [c:daf92ed]
 
 ### Fixed
 
-- MessageBuilder channel/role/user methods now properly mention the given
-  item ([@fwrs])
-- No-cache+method compiles have been fixed
-- `rest::edit_profile` no longer updated the internal token for bot users; this
-  is a preliminary fix, as the endpoint will soon not return `"Bot "` in the
-  token key for bot users
+- Fix mentioning in the `MessageBuilder` ([@fwrs]) [c:13de5c2]
+- Don't mutate token for bots on profile change [c:8effc91]
 
 ### Changed
 
-- `model::Mention` has been removed, in favour of simply
-  `model_name::mention()` (BC break) ([@fwrs])
-- Ids now mention where possible on format; use Id.0 to format the inner
-  snowflake directly (BC break) ([@fwrs])
-- All internal `try!()`s have been converted to use rustc 1.13's `?`
-  ([@acdenisSK])
-- `CreateEmbedImage::{height, width}` and
-  `CreateEmbedThumbnail::{height, width}` have been deprecated, as these do
-  not do anything and there seems to not be any plans on Discord's side to make
-  them do anything. These will be removed in v0.1.3 and the builders themselves
-  will be replaced with methods on `CreateEmbed` (BC break)
+- Deprecate `CreateEmbedImage::{height, width}` and
+  `CreateEmbedThumbnail::{height, width}`
+
+### Misc.
 
+- All internal `try!`s have been converted to use `?` syntax ([@acdenisSK])
+  [c:f69512b]
 
 ## [0.1.1] - 2016-12-05
 
@@ -411,27 +435,46 @@ Thanks to the following for contributions this release:
 
 v0.1.1 can now be retrieved from the [crates.io listing].
 
+[v0.1.1:example 06]: https://github.com/zeyla/serenity/tree/ccb9d16e5dbe965e5a604e1cb402cd3bc7de0df5/examples/06_command_framework
+
+### Upgrade Path
+
+When calling `rest::get_guilds`, instead of passing no parameters, pass a
+`GuildPagination` variant and a `limit`:
+
+```rust
+use serenity::client::rest::{self, GuildPagination};
+use serenity::model::GuildId;
+
+// before
+rest::get_guilds();
+
+// after
+rest::get_guilds(GuildPagination::After(GuildId(777)), 50);
+```
+
 ### Added
 
 - The following colours to the Colour struct:
-  - "Kerbal" ([@indiv0])
-  - "Blurple" ([@GetRektByMe])
-  - "Blitz Blue" ([@iCrawl])
-  - "Fabled Pink" ([@Flat])
-  - "Fooyoo" ([@SunDwarf])
-  - "Rosewater" ([@fwrs])
-- `Message::guild_id` as a quick method for retrieving the Id of a message's guild
+  - "Kerbal" ([@indiv0]) [c:c032fbe]
+  - "Blurple" ([@GetRektByMe]) [c:e9282d3]
+  - "Blitz Blue" ([@iCrawl]) [c:f53124e]
+  - "Fabled Pink" ([@Flat]) [c:9aa357f]
+  - "Fooyoo" ([@SunDwarf]) [c:49a6841]
+  - "Rosewater" ([@fwrs]) [c:2eaa415]
+- `Message::guild_id` as a quick method for retrieving the Id of a message's
+  guild [c:bceb049]
 - `CurrentUser::guilds()` to get the current user's guilds. Meant for use with
-  selfbots
-- `CurrentUser::edit()` to edit the current user's profile settings
+  selfbots [c:57c060f]
+- `CurrentUser::edit()` to edit the current user's profile settings [c:16d1b3c]
 - `User::distinct` to format a string with the `username#discriminator`
-  combination ([@fwrs])
-- `Member::colour` to retrieve the member's colour ([@fwrs])
-- Roles can now be directly compared (`role1 < role2`) for hierarchy
+  combination ([@fwrs]) [c:31becb1]
+- `Member::colour` to retrieve the member's colour ([@fwrs]) [c:43a5c5d]
+- Roles can now be directly compared (`role1 < role2`) for hierarchy [c:143337a]
 - Documentation:
-  - `EditMember` and `EditProfile` ([@Kiseii])
-  - Documentation for 19 model definitions ([@fwrs])
-  - Context permission requirements
+  - `EditMember` and `EditProfile` ([@Kiseii]) [c:e2557ac]
+  - Documentation for 19 model definitions ([@fwrs]) [c:2844ae1]
+  - Context + permission requirements [c:d144136]
 - A custom shared state (not the Cache) can now be accessed and mutated across
   commands/contexts, through the use of `Context.data`'s ShareMap. See
   [example 06][v0.1.1:example 06] for an example
@@ -439,26 +482,24 @@ v0.1.1 can now be retrieved from the [crates.io listing].
 ### Fixed
 
 - `rest::start_integration_sync`/`Context::start_integration_sync` now properly
-  work ([@abalabahaha])
+  work ([@abalabahaha]) [c:7f04179]
 - Role positions can now be negative; fixes issues where a guild's @everyone
-  role (and other roles) are negative
-- `Context::move_member`'s signature is now correct
-
-### Changed
-
-- `Colour::dark_green` is now sorted alphabetically ([@khazhyk])
+  role (and other roles) are negative [c:f847638]
+- `Context::move_member`'s signature is now correct [c:4de39da]
 - The `command!` macro now publicly exports functions. This allows commands
   created via this macro to be separated into different modules or crates
-- `rest::get_guilds` now supports pagination of guilds, as the output is now
-  limited to 100
+  [c:62ed564]
 
-### Backwards Compatibility Breaks
+### Changed
 
-None
+- `rest::get_guilds` now supports pagination of guilds, as the output is now
+  limited to 100 [c:57c060f]
 
-Clause: backwards compatibility breaks are ones that are _not_ due to a change
-in Discord's API.
+### Misc.
 
+- `Colour::dark_green` is now sorted alphabetically ([@khazhyk]) [c:4a14b92]
+- Simplify the colour macro [c:bb97211]
+- Capitalize the hex value for `Colour::blitz_blue` ([@Kiseii]) [c:daa24ec]
 
 ## [0.1.0] - 2016-11-30
 
@@ -472,8 +513,6 @@ Initial commit.
 [0.1.0]: https://github.com/zeyla/serenity/tree/403d65d5e98bdfa9f0c018610000c4a0b0c7d8d5
 [crates.io listing]: https://crates.io/crates/serenity
 [semver]: http://semver.org
-[v0.1.2:example 06]: https://github.com/zeyla/serenity/tree/5a3665a9951c023e3e6ea688844558b7f8b5fb6e/examples/06_command_framework
-[v0.1.1:example 06]: https://github.com/zeyla/serenity/tree/ccb9d16e5dbe965e5a604e1cb402cd3bc7de0df5/examples/06_command_framework
 
 [@abalabahaha]: https://github.com/abalabahaha
 [@acdenisSK]: https://github.com/acdenisSK
@@ -489,3 +528,113 @@ Initial commit.
 [@indiv0]: https://github.com/indiv0
 [@khazhyk]: https://github.com/khazhyk
 [@SunDwarf]: https://github.com/SunDwarf
+
+[c:00fb61b]: https://github.com/zeyla/serenity/commit/00fb61b5f306aebde767cc21a498a8ca0742d0be
+[c:04cfaa9]: https://github.com/zeyla/serenity/commit/04cfaa9a69dc1638e9cd1904a9b8e94c1a97f832
+[c:0708ccf]: https://github.com/zeyla/serenity/commit/0708ccf85bac347e59053133a2b8b6f2eabe99ba
+[c:096b0f5]: https://github.com/zeyla/serenity/commit/096b0f57aae04a5e0ea28414f5016eeafc5b9e0a
+[c:0a2f5ab]: https://github.com/zeyla/serenity/commit/0a2f5ab525022fbf0055649f2262573fb07cf18c
+[c:0b9bf91]: https://github.com/zeyla/serenity/commit/0b9bf91f62eef85a4eca703902077f4c04b3b6d1
+[c:0ec4dfb]: https://github.com/zeyla/serenity/commit/0ec4dfb785459c0d04c295f84a1c33e71c016eba
+[c:13de5c2]: https://github.com/zeyla/serenity/commit/13de5c2e50410c3a68435dc774537b490bb7115c
+[c:143337a]: https://github.com/zeyla/serenity/commit/143337ae717773f59562d67f85d0e9c44063a45b
+[c:147cf01]: https://github.com/zeyla/serenity/commit/147cf01d4f13e3ee15eb03705ab2b7a006851cdd
+[c:1594961]: https://github.com/zeyla/serenity/commit/159496188b2c841a65829328cddafef620c517af
+[c:16bd765]: https://github.com/zeyla/serenity/commit/16bd765112befd5d81818cab7b97ac59bd8a1b75
+[c:16d1b3c]: https://github.com/zeyla/serenity/commit/16d1b3cad3982accd805f64ef93e51d921b3da55
+[c:2416813]: https://github.com/zeyla/serenity/commit/24168137ff7b1ec44d3ecdec0f516455fd3785a7
+[c:268f356]: https://github.com/zeyla/serenity/commit/268f356a25f27175a5d72458fff92b0f770d0a5a
+[c:2844ae1]: https://github.com/zeyla/serenity/commit/2844ae158f3d8297b17a584ff9a75f1f51116f48
+[c:2a743ce]: https://github.com/zeyla/serenity/commit/2a743cedaf08f7eb532e3c4b795cfc5f85bc96af
+[c:2b237e7]: https://github.com/zeyla/serenity/commit/2b237e7de221beab9c516d6de29f83188ef63840
+[c:2cb607d]: https://github.com/zeyla/serenity/commit/2cb607d72a39aa7ab3df866b23de4c9798e69a0f
+[c:2eaa415]: https://github.com/zeyla/serenity/commit/2eaa4159955260e7c9ade66803d69865f1f76018
+[c:31becb1]: https://github.com/zeyla/serenity/commit/31becb16f184cd7d396b383ad4abed8095451fcb
+[c:3348178]: https://github.com/zeyla/serenity/commit/3348178f151d8e1d7aa0432984a2dd23fa7b9e89
+[c:345e140]: https://github.com/zeyla/serenity/commit/345e1401142d21a0fdabb2accd1f33e3a07c02c8
+[c:38a484d]: https://github.com/zeyla/serenity/commit/38a484d0fec91e290bc1633fc871131f9decd0ca
+[c:38db32e]: https://github.com/zeyla/serenity/commit/38db32e2cbb9dc8504e0dfbc2366b17596836da0
+[c:3ca7ad9]: https://github.com/zeyla/serenity/commit/3ca7ad92507f056054d081485f437c08505bc7e5
+[c:4229034]: https://github.com/zeyla/serenity/commit/42290348bc05c876b7e70c570a485160e594e098
+[c:43a5c5d]: https://github.com/zeyla/serenity/commit/43a5c5d7eb8bffb8c9ca450ab1bc377d602fb8c3
+[c:49a6841]: https://github.com/zeyla/serenity/commit/49a684134df32427e9502192122c4fb22ef1a735
+[c:4a14b92]: https://github.com/zeyla/serenity/commit/4a14b92ff58173acb98c7e0a135b4989a87a7529
+[c:4cf8338]: https://github.com/zeyla/serenity/commit/4cf8338e364b0feefef26ece6649077e87962ff3
+[c:4de39da]: https://github.com/zeyla/serenity/commit/4de39da887248e374b4d824472a6422c7e46dacc
+[c:55ccaca]: https://github.com/zeyla/serenity/commit/55ccaca57051b3fbd47cf7fa288014d9c36f6952
+[c:57c060f]: https://github.com/zeyla/serenity/commit/57c060fa2fccfbb3b3d4b2d18aad2faa5929deb3
+[c:5918d01]: https://github.com/zeyla/serenity/commit/5918d01ed69541e43aed0e62ee6eadbf5ebb20d2
+[c:5b275fc]: https://github.com/zeyla/serenity/commit/5b275fc425d4ef1c1a9eaa9d915db1f873f9c11d
+[c:5c40e85]: https://github.com/zeyla/serenity/commit/5c40e85001b9b2620a76fcc57d8f0cddfb6f9b34
+[c:5ee5fef]: https://github.com/zeyla/serenity/commit/5ee5feff615565b6f661ee3598fe19bb98bd6a88
+[c:5fe6a39]: https://github.com/zeyla/serenity/commit/5fe6a3956d39e9b5caef19df78e8b392898b6908
+[c:626ffb2]: https://github.com/zeyla/serenity/commit/626ffb25af35f5b91a76fdccf6788382a1c39455
+[c:62ed564]: https://github.com/zeyla/serenity/commit/62ed564e5f67f3e25d2307fbbf950d0489a28de8
+[c:6355288]: https://github.com/zeyla/serenity/commit/635528875c59d34f0d7b2f2b0a3bd61d762f0e9c
+[c:651c618]: https://github.com/zeyla/serenity/commit/651c618f17cb92d3ea9bbd1d5f5c92a015ff64e0
+[c:66546d3]: https://github.com/zeyla/serenity/commit/66546d36749f6c78a4957a616524fab734d5c972
+[c:68c473d]: https://github.com/zeyla/serenity/commit/68c473dd17a2098f97808b3d1f2a200621f67c9d
+[c:69ec62a]: https://github.com/zeyla/serenity/commit/69ec62a42bcb143cdde056ad8ffce81922e88317
+[c:6a887b2]: https://github.com/zeyla/serenity/commit/6a887b25f2712d70c65fc85b5cfbd8b6d4b41260
+[c:6f33a35]: https://github.com/zeyla/serenity/commit/6f33a35c4f85a06c45c4ce9e118db203c4951475
+[c:70bf22a]: https://github.com/zeyla/serenity/commit/70bf22a00cd19651a0d994cc43e8d8c4bd8947fc
+[c:760a47a]: https://github.com/zeyla/serenity/commit/760a47aa4d34160f44048e775afeb30f08891c99
+[c:76f9095]: https://github.com/zeyla/serenity/commit/76f9095c012a8769c7bd27aca6540b7018574c28
+[c:7914274]: https://github.com/zeyla/serenity/commit/79142745cb571ba2d4284fd1dcbe53c14a0ed623
+[c:7b45f16]: https://github.com/zeyla/serenity/commit/7b45f16f063a47dc8a302dce5b016cf43a3edcc1
+[c:7b4b154]: https://github.com/zeyla/serenity/commit/7b4b1544603a70dd634b51593ea5173b4515889a
+[c:7f04179]: https://github.com/zeyla/serenity/commit/7f041791aa95e38a0cacd2ab64f0423524c60052
+[c:83b29d5]: https://github.com/zeyla/serenity/commit/83b29d5f839cd2ea6cd150aa7b8ccbbc677c1fad
+[c:86cd00f]: https://github.com/zeyla/serenity/commit/86cd00f20d6f218e524deed040d3c209f0361a86
+[c:8c5ee70]: https://github.com/zeyla/serenity/commit/8c5ee70b28b42ac92f899932ab2ddafeb9c6f913
+[c:8e2c052]: https://github.com/zeyla/serenity/commit/8e2c052a55e5e08c6e7ed643b399f1a7f69a2b25
+[c:8effc91]: https://github.com/zeyla/serenity/commit/8effc918cc3d269b0d4cf34ef4f2053cecad2606
+[c:8f24aa3]: https://github.com/zeyla/serenity/commit/8f24aa391f6b8a9103a9c105138c7610288acb05
+[c:92309b2]: https://github.com/zeyla/serenity/commit/92309b2fb8ffd96292fd2edaa7c223a2ba774a56
+[c:933ee89]: https://github.com/zeyla/serenity/commit/933ee8914509e52c5119ced9f5d9d8f9644cfa63
+[c:9392f61]: https://github.com/zeyla/serenity/commit/9392f61f8857b6ab2a04781c2d9c92a582a1577b
+[c:93f3c60]: https://github.com/zeyla/serenity/commit/93f3c60b23cb8ffd16666bdc01b3502ca7ba5f47
+[c:97f9bd1]: https://github.com/zeyla/serenity/commit/97f9bd10c16eb24d54a0ab00c52f19eb51a88675
+[c:9aa357f]: https://github.com/zeyla/serenity/commit/9aa357f0c8f504b53b49824cc20561c8501d2dda
+[c:9c1ed6c]: https://github.com/zeyla/serenity/commit/9c1ed6ca933f81bc0254d9d52159b9190b50a3ea
+[c:a2cbeb6]: https://github.com/zeyla/serenity/commit/a2cbeb6ece9ef56e2082b6eabbabe5fe536ab3ec
+[c:a39647d]: https://github.com/zeyla/serenity/commit/a39647d3ba1650a4dd4c92bd40001959828000c7
+[c:a8acd61]: https://github.com/zeyla/serenity/commit/a8acd6138741a6e5268141ac4ce902561931d353
+[c:ab778f8]: https://github.com/zeyla/serenity/commit/ab778f8a9cf47c4e27fe688a61effb0caa4f8a6e
+[c:abd22d2]: https://github.com/zeyla/serenity/commit/abd22d289599530cbd1bc9cf1b739420f0d22372
+[c:ada07fa]: https://github.com/zeyla/serenity/commit/ada07fae09f3521f44d81613f26839d69c1fc7ef
+[c:b001234]: https://github.com/zeyla/serenity/commit/b0012349cca2a5c7c62bb6d2c99106d245b6c55a
+[c:b7cbf75]: https://github.com/zeyla/serenity/commit/b7cbf75103939b0b7834c808050b19ba4fbc4b17
+[c:bb97211]: https://github.com/zeyla/serenity/commit/bb97211b2b107943dd6fabb7a0a344d4fe236780
+[c:bcb70e8]: https://github.com/zeyla/serenity/commit/bcb70e85384a16b2440788a73241f507aaeba4dc
+[c:bceb049]: https://github.com/zeyla/serenity/commit/bceb049bb2b804dac975567bb7eac6afcfc28574
+[c:c01f238]: https://github.com/zeyla/serenity/commit/c01f238a34ad846f8732c8bf97fbbd96fbf6a7ae
+[c:c032fbe]: https://github.com/zeyla/serenity/commit/c032fbe7a5c65fb6824a5eb36daf327134b854cf
+[c:c050c59]: https://github.com/zeyla/serenity/commit/c050c59da25b9093a75bda22baa81be3b267c688
+[c:c2e8b69]: https://github.com/zeyla/serenity/commit/c2e8b69702cf81a1cf149c420aec999124f398e2
+[c:c36841d]: https://github.com/zeyla/serenity/commit/c36841dd1c3f80141251ba01130333f43ff363d7
+[c:c8c6b83]: https://github.com/zeyla/serenity/commit/c8c6b83ca685a3e503c853d4154a17761790954e
+[c:d144136]: https://github.com/zeyla/serenity/commit/d1441363364970b749d57b8a4863b284239488d1
+[c:d3389be]: https://github.com/zeyla/serenity/commit/d3389be3042fd7977350a08152d177ac6cdcd37f
+[c:d58c544]: https://github.com/zeyla/serenity/commit/d58c54425a18bbbdc8e66e8eebfb8191bad06901
+[c:daf92ed]: https://github.com/zeyla/serenity/commit/daf92eda815b8f539f6d759ab48cf7a70513915f
+[c:e2557ac]: https://github.com/zeyla/serenity/commit/e2557ac794068c1a6a5c4c674ed9f7b7a806068e
+[c:e5a83dd]: https://github.com/zeyla/serenity/commit/e5a83dd1873e5af2df18835d960fe19286c70f1e
+[c:e85e901]: https://github.com/zeyla/serenity/commit/e85e901062e8b9ea717ec6c6253c9c7a300448d3
+[c:e891ebe]: https://github.com/zeyla/serenity/commit/e891ebeba43eb87c985db4e031b8bf76dcaca67b
+[c:e8a9086]: https://github.com/zeyla/serenity/commit/e8a90860d1e451e21d3bf728178957fe54cf106d
+[c:e9282d3]: https://github.com/zeyla/serenity/commit/e9282d3373158b6e9792a5484ae3dfb9212eb6f7
+[c:e9aae9c]: https://github.com/zeyla/serenity/commit/e9aae9c043b206b15bd5429126ded62259d6731b
+[c:eb09f2d]: https://github.com/zeyla/serenity/commit/eb09f2d3389b135978e0671a0e7e4ed299014f94
+[c:ef6eba3]: https://github.com/zeyla/serenity/commit/ef6eba37636a487c0d6f3b93b8e76c94f28abbab
+[c:f00e165]: https://github.com/zeyla/serenity/commit/f00e1654e8549ec6582c6f3a8fc4af6aadd56015
+[c:f3f74ce]: https://github.com/zeyla/serenity/commit/f3f74ce43f8429c4c9e38ab7b905fb5a24432fd4
+[c:f53124e]: https://github.com/zeyla/serenity/commit/f53124ec952124f5b742f204cdf7e1dc00a168ab
+[c:f57a187]: https://github.com/zeyla/serenity/commit/f57a187d564bdcd77f568e77a102d6d261832ee0
+[c:f69512b]: https://github.com/zeyla/serenity/commit/f69512beaa157775accd4392295dba112adcf1df
+[c:f847638]: https://github.com/zeyla/serenity/commit/f847638859423ffaaecfdb77ee5348a607ad3293
+[c:f894cfd]: https://github.com/zeyla/serenity/commit/f894cfdc43a708f457273e1afb57ed1c6e8ebc58
+[c:f96b6cc]: https://github.com/zeyla/serenity/commit/f96b6cc5e1e0383fd2de826c8ffd95565d5ca4fb
+[c:fafa363]: https://github.com/zeyla/serenity/commit/fafa3637e760f0c72ae5793127bc2f70dcf2d0e2
+[c:fb07751]: https://github.com/zeyla/serenity/commit/fb07751cfc1efb657cba7005c38ed5ec6b192b4f
+[c:fb4d411]: https://github.com/zeyla/serenity/commit/fb4d411054fa44928b4fa052b19de19fce69d7cf