diff --git a/CHANGELOG.md b/CHANGELOG.md
index bb8f19f..f512c54 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,14 +2,21 @@
 
 This document describes the changes to Minimq between releases.
 
-# Unreleased
+# [Unreleased]
+
+## Added
+## Removed
+## Changed
+
+# Version [0.5.0]
+Version 0.5.0 was published on 2021-12-06
 
 ## Added
 * Support for the `Will` message specification.
 * [breaking] Adding `retained` flag to `publish()` to allow messages to be published in a retained
   manner.
 
-# Version 0.4.0
+# Version [0.4.0]
 Version 0.4.0 was published on 2021-10-08
 
 * Updating to `std-embedded-nal` v0.1 (dev dependency only; now again used for integration tests)
@@ -21,7 +28,7 @@ keep-alive interval
 * Refactoring network stack management into a separate container class
 * Keep-alive settings now take a u16 integer number of seconds
 
-# Version 0.3.0
+# Version [0.3.0]
 Version 0.3.0 was published on 2021-08-06
 
 * Client ID may now be unspecified to allow the broker to automatically assign an ID.
@@ -36,7 +43,7 @@ Version 0.3.0 was published on 2021-08-06
 * Removing using of `generic-array` in favor of const-generics.
 * Correcting an issue where the client would not reconnect if the broker was restarted.
 
-# Version 0.2.0
+# Version [0.2.0]
 Version 0.2.0 was published on 2021-02-15
 
 * Updating the `MqttClient::poll()` function to take a `FnMut` closure to allow internal state
@@ -47,7 +54,14 @@ Version 0.2.0 was published on 2021-02-15
   stack errors out to the user.
 * Updating library to re-export `generic-array` publicly.
 
-## Version 0.1.0
+## Version [0.1.0]
 Version 0.1.0 was published on 2020-08-27
 
 * Initial library release and publish to crates.io
+
+[Unreleased]: https://github.com/quartiq/minimq/compare/0.5.0...HEAD
+[0.5.0]: https://github.com/quartiq/minimq/releases/tag/0.5.0
+[0.4.0]: https://github.com/quartiq/minimq/releases/tag/0.4.0
+[0.3.0]: https://github.com/quartiq/minimq/releases/tag/0.3.0
+[0.2.0]: https://github.com/quartiq/minimq/releases/tag/0.2.0
+[0.1.0]: https://github.com/quartiq/minimq/releases/tag/0.1.0
diff --git a/Cargo.toml b/Cargo.toml
index 24f3ce0..8bbd0a5 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "minimq"
-version = "0.4.0"
+version = "0.5.0"
 authors = ["Ryan Summers <ryan.summers@vertigo-designs.com>", "Max Rottenkolber <max@mr.gy>"]
 edition = "2018"
 
diff --git a/src/lib.rs b/src/lib.rs
index 162c02e..7a3001a 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -8,8 +8,7 @@
 //! # Limitations
 //! This library does not currently support the following elements:
 //! * Quality-of-service `ExactlyOnce`
-//! * Session timeouts
-//! * Server keep alive timeouts (ping)
+//! * Quality-of-service above `AtMostOnce` for inbound messages.
 //! * Bulk subscriptions
 //! * Server Authentication
 //! * Encryption