Add some docs links and such

src/io/mod.rs

@@ -2,6 +2,12 @@
 //!
 //! Contains various combinators to work with I/O objects and type definitions
 //! as well.
+//!
+//! A description of the high-level I/O combinators can be [found online] in
+//! addition to a description of the [low level details].
+//!
+//! [found online]: https://tokio.rs/docs/getting-started/core/
+//! [low level details]: https://tokio.rs/docs/going-deeper/core-low-level/
 
 use std::io;
 

src/reactor/poll_evented.rs

@@ -32,6 +32,10 @@ use reactor::io_token::IoToken;
 /// It's the responsibility of the wrapper to inform the readiness stream when a
 /// "would block" I/O event is seen. The readiness stream will then take care of
 /// any scheduling necessary to get notified when the event is ready again.
+///
+/// You can find more information about creating a custom I/O object [online].
+///
+/// [online]: https://tokio.rs/docs/going-deeper/core-low-level/#custom-io
 pub struct PollEvented<E> {
     token: IoToken,
     handle: Remote,