-This Rust crate provides a reliable, fault-tolerant, and brokerless message-queue abstraction over
-asynchronous network streams.
+[![Crates.io][crates-badge]][crates-url]
+[![Docs.rs][docs-badge]][docs-url]
+
+[crates-badge]: https://img.shields.io/crates/v/connect.svg
+[crates-url]: https://crates.io/crates/connect
+[docs-badge]: https://docs.rs/connect/badge.svg
+[docs-url]: https://docs.rs/connect
+
+This Rust crate provides a simple brokerless message-queue abstraction over asynchronous network
+streams.
+
+## Examples
+Please use the [example programs](https://github.com/sachanganesh/connect-rs/tree/main/examples)
+provided to help understand crate usage.