diff --git a/README.md b/README.md
index d477fba..875b193 100644
--- a/README.md
+++ b/README.md
@@ -1,31 +1,86 @@
-# async-task
+
async-task
+
+
+ A task abstraction for building executors.
+
+
-[](https://travis-ci.com/async-rs/async-task)
-[](
-https://github.com/async-rs/async-task)
-[](https://crates.io/crates/async-task)
-[](https://docs.rs/async-task)
-[](https://discord.gg/JvZeVNe)
+
-Task abstraction for building executors.
+
-To spawn a future onto an executor, we first need to allocate it on the heap and keep some
-state alongside it. The state indicates whether the future is ready for polling, waiting to be
-woken up, or completed. Such a future is called a *task*.
+
-This crate helps with task allocation and polling its future to completion.
+## Installation
-## License
+With [cargo add][cargo-add] installed run:
+
+```sh
+$ cargo add async-task
+```
+
+[cargo-add]: https://github.com/killercup/cargo-edit
+
+## Safety
+This crate makes use of carefully checked `unsafe` blocks to construct an
+efficient timer implementation.
-Licensed under either of
+## Contributing
+Want to join us? Check out our ["Contributing" guide][contributing] and take a
+look at some of these issues:
- * Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
- * MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)
+- [Issues labeled "good first issue"][good-first-issue]
+- [Issues labeled "help wanted"][help-wanted]
+
+[contributing]: https://github.com/async-rs/async-task/blob/master.github/CONTRIBUTING.md
+[good-first-issue]: https://github.com/async-rs/async-task/labels/good%20first%20issue
+[help-wanted]: https://github.com/async-rs/async-task/labels/help%20wanted
+
+## License
-at your option.
+
+Licensed under either of Apache License, Version
+2.0 or MIT license at your option.
+
-#### Contribution
+
+
Unless you explicitly state otherwise, any contribution intentionally submitted
-for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
-dual licensed as above, without any additional terms or conditions.
+for inclusion in this crate by you, as defined in the Apache-2.0 license, shall
+be dual licensed as above, without any additional terms or conditions.
+