fix docs to be more readable

diff --git a/README.md b/README.md
index bdf89a06bb217deda27914be5a16712d89083fd2..65b42dcb7e51d9cd0ab30c12d50d95cc5ee92e07 100644 (file)
--- a/README.md
+++ b/README.md
@@ -8,7 +8,7 @@
 [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
+This Rust crate provides a simple, brokerless message-queue abstraction over asynchronous network
 streams.
 
 ## Examples

diff --git a/src/lib.rs b/src/lib.rs
index 522db960cb6c6c824d70deb6bb20c1813be194fb..b3c3232504eda596d25d1227fd4e4b7a0b82d975 100644 (file)
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -1,4 +1,4 @@
-//! This crate provides a simple brokerless message-queue abstraction over asynchronous network
+//! This crate provides a simple, brokerless message-queue abstraction over asynchronous network
 //! streams.
 //!
 //! # Examples

diff --git a/src/tls/mod.rs b/src/tls/mod.rs
index a0b7f10e1d890d55757d0d9c8d1874146f5cca34..8e62369d3034ed4d151dbfbbc1a0f68f21ae18c0 100644 (file)
--- a/src/tls/mod.rs
+++ b/src/tls/mod.rs
@@ -27,8 +27,8 @@ pub use async_tls;
 #[doc(cfg(feature = "tls"))]
 pub use rustls;
 
-/// Used to differentiate between an outgoing connection ([`TlsConnectionMetadata::Client`]) or
-/// incoming connection listener ([`TlsConnectionMetadata::Listener`]).
+/// Used to differentiate between an outgoing connection ([Client](`TlsConnectionMetadata::Client`))
+/// or incoming connection listener ([Listener](`TlsConnectionMetadata::Listener`)).
 ///
 /// The async TLS library used by this crate has two differing stream types based on whether the
 /// connection being established is either a client or server. This is to aid with handling that