update docs regarding links and getting started

Author: glendc

README.md

@@ -101,6 +101,17 @@ check out some of the original Tower [guides].
 We work exactly the same as Tower, expect in an async manner and slightly easier to use as such.
 But the core ideas are obviously the same, so it should never the less help you to get started.
 
+Browse the examples at [`tower-async-http/examples`](https://github.com/plabayo/tower-async/tree/master/tower-async-http/examples) to see some examples
+on how to use `tower-async` and its sibling crates. While these are focussed on http examples,
+note that:
+
+- `tower-async` can work for any request-response flow (akin to `tower`);
+- you can also use `tower-async` with http web services without making use of the `tower-async-http` crate,
+  it only is there to provide extra middleware for http-specific purposes, but this is all optional.
+
+The documentation also contains some smaller examples and of course the codebase can be read as well,
+together with its unit tests.
+
 ## Sponsorship
 
 Regular and onetime sponsors alike help us to pay the development and service costs
@@ -181,8 +192,8 @@ We do not have a roadmap for Tower Async. But here are some ideas on what you ca
 [`tower::ServiceBuilder`]: https://docs.rs/tower/*/tower/builder/struct.ServiceBuilder.html
 [`tower::Layer`]: https://docs.rs/tower/*/tower/trait.Layer.html
 [`tower_async`]: https://docs.rs/tower-async/*/tower_async
-[`tower_async::Service`]: https://docs.rs/tower-async/*/tower_async/trait.Service.html
+[`tower_async::Service`]: https://docs.rs/tower-async-service/*/tower_async_service/trait.Service.html
 [`tower_async::ServiceBuilder`]: https://docs.rs/tower-async/*/tower_async/builder/struct.ServiceBuilder.html
-[`tower_async::Layer`]: https://docs.rs/tower-async/*/tower_async/trait.Layer.html
+[`tower_async::Layer`]: https://docs.rs/tower-async-layer/*/tower_async_layer/trait.Layer.html
 
 [guides]: https://github.com/tower-rs/tower/tree/master/guides

tower-async-bridge/src/lib.rs

@@ -31,9 +31,9 @@
 //! [`tower::ServiceBuilder`]: https://docs.rs/tower/*/tower/builder/struct.ServiceBuilder.html
 //! [`tower::Layer`]: https://docs.rs/tower/*/tower/trait.Layer.html
 //! [`tower_async`]: https://docs.rs/tower-async/*/tower_async
-//! [`tower_async::Service`]: https://docs.rs/tower-async/*/tower_async/trait.Service.html
+//! [`tower_async::Service`]: https://docs.rs/tower-async-service/*/tower_async_service/trait.Service.html
 //! [`tower_async::ServiceBuilder`]: https://docs.rs/tower-async/*/tower_async/builder/struct.ServiceBuilder.html
-//! [`tower_async::Layer`]: https://docs.rs/tower-async/*/tower_async/trait.Layer.html
+//! [`tower_async::Layer`]: https://docs.rs/tower-async-layer/*/tower_async_layer/trait.Layer.html
 
 #[cfg(feature = "into_async")]
 mod into_async;

tower-async-layer/README.md

@@ -25,7 +25,7 @@ to integrate async functions into middleware.
 This fork is made entirely with the needs of the author in mind,
 and thus might not yet contain all features you might need.
 
-Come join us at discord at <https://discord.com/channels/1114459060050333696/1123537825929900113>
+Come join us at discord on the `#tower-async` public channel at [Discord](https://discord.gg/29EetaSYCD)
 or tag `@glendc` at Tokio's Tower discord instead.
 
 Where suitable we'll keep in sync (manually) with Tower and if the

tower-async-service/README.md

@@ -25,7 +25,7 @@ to integrate async functions into middleware.
 This fork is made entirely with the needs of the author in mind,
 and thus might not yet contain all features you might need.
 
-Come join us at discord at <https://discord.com/channels/1114459060050333696/1123537825929900113>
+Come join us at discord on the `#tower-async` public channel at [Discord](https://discord.gg/29EetaSYCD)
 or tag `@glendc` at Tokio's Tower discord instead.
 
 Where suitable we'll keep in sync (manually) with Tower and if the

tower-async/README.md

@@ -116,7 +116,7 @@ with this (Aync Trait) version (Fork).
 
 ## Usage
 
-Tower provides an abstraction layer, and generic implementations of various
+Tower (Async) provides an abstraction layer, and generic implementations of various
 middleware. This means that the `tower-async` crate on its own does *not* provide
 a working implementation of a network client or server. Instead, Tower's
 [`Service` trait][`Service`] provides an integration point between
@@ -170,19 +170,30 @@ To get started using all of Tower's optional middleware, add this to your
 `Cargo.toml`:
 
 ```toml
-tower-async = { version = "0.4", features = ["full"] }
+tower-async = { version = "0.1", features = ["full"] }
 ```
 
 Alternatively, you can only enable some features. For example, to enable
 only the [`timeout`][timeouts] middleware, write:
 
 ```toml
-tower-async = { version = "0.4", features = ["timeout"] }
+tower-async = { version = "0.1", features = ["timeout"] }
 ```
 
 See [here][all_layers] for a complete list of all middleware provided by
 Tower.
 
+Browse the examples at [`tower-async-http/examples`](https://github.com/plabayo/tower-async/tree/master/tower-async-http/examples) to see some examples
+on how to use `tower-async` and its sibling crates. While these are focussed on http examples,
+note that:
+
+- `tower-async` can work for any request-response flow (akin to `tower`);
+- you can also use `tower-async` with http web services without making use of the `tower-async-http` crate,
+  it only is there to provide extra middleware for http-specific purposes, but this is all optional.
+
+The documentation also contains some smaller examples and of course the codebase can be read as well,
+together with its unit tests.
+
 [`Service`]: https://docs.rs/tower-async/latest/tower-async/trait.Service.html
 [`Layer`]: https://docs.rs/tower-async/latest/tower-async/trait.Layer.html
 [all_layers]: https://docs.rs/tower-async/latest/tower-async/#modules
@@ -200,9 +211,9 @@ Tower.
 [`tower::ServiceBuilder`]: https://docs.rs/tower/*/tower/builder/struct.ServiceBuilder.html
 [`tower::Layer`]: https://docs.rs/tower/*/tower/trait.Layer.html
 [`tower_async`]: https://docs.rs/tower-async/*/tower_async
-[`tower_async::Service`]: https://docs.rs/tower-async/*/tower_async/trait.Service.html
+[`tower_async::Service`]: https://docs.rs/tower-async-service/*/tower_async_service/trait.Service.html
 [`tower_async::ServiceBuilder`]: https://docs.rs/tower-async/*/tower_async/builder/struct.ServiceBuilder.html
-[`tower_async::Layer`]: https://docs.rs/tower-async/*/tower_async/trait.Layer.html
+[`tower_async::Layer`]: https://docs.rs/tower-async-layer/*/tower_async_layer/trait.Layer.html
 
 
 ## Supported Rust Versions

tower-async/src/lib.rs

@@ -158,18 +158,29 @@
 //! `Cargo.toml`:
 //!
 //! ```toml
-//! tower-async = { version = "0.4", features = ["full"] }
+//! tower-async = { version = "0.1", features = ["full"] }
 //! ```
 //!
 //! Alternatively, you can only enable some features. For example,
 //! to enable only the [`timeout`][timeouts] middleware, write:
 //!
 //! ```toml
-//! tower-async = { version = "0.4", features = ["timeout"] }
+//! tower-async = { version = "0.1", features = ["timeout"] }
 //! ```
 //!
 //! See [here][all_layers] for a complete list of all middleware provided by
 //! Tower.
+//! 
+//! Browse the examples at [`tower-async-http/examples`](https://github.com/plabayo/tower-async/tree/master/tower-async-http/examples) to see some examples
+//! on how to use `tower-async` and its sibling crates. While these are focussed on http examples,
+//! note that:
+//! 
+//! - `tower-async` can work for any request-response flow (akin to `tower`);
+//! - you can also use `tower-async` with http web services without making use of the `tower-async-http` crate,
+//!   it only is there to provide extra middleware for http-specific purposes, but this is all optional.
+//! 
+//! The documentation also contains some smaller examples and of course the codebase can be read as well,
+//! together with its unit tests.
 //!
 //! [`Service`]: https://docs.rs/tower-async/latest/tower-async/trait.Service.html
 //! [`Layer`]: https://docs.rs/tower-async/latest/tower-async/trait.Layer.html
@@ -188,9 +199,9 @@
 //! [`tower::ServiceBuilder`]: https://docs.rs/tower/*/tower/builder/struct.ServiceBuilder.html
 //! [`tower::Layer`]: https://docs.rs/tower/*/tower/trait.Layer.html
 //! [`tower_async`]: https://docs.rs/tower-async/*/tower_async
-//! [`tower_async::Service`]: https://docs.rs/tower-async/*/tower_async/trait.Service.html
+//! [`tower_async::Service`]: https://docs.rs/tower-async-service/*/tower_async_service/trait.Service.html
 //! [`tower_async::ServiceBuilder`]: https://docs.rs/tower-async/*/tower_async/builder/struct.ServiceBuilder.html
-//! [`tower_async::Layer`]: https://docs.rs/tower-async/*/tower_async/trait.Layer.html
+//! [`tower_async::Layer`]: https://docs.rs/tower-async-layer/*/tower_async_layer/trait.Layer.html
 //!
 //! ## Supported Rust Versions
 //!