tokio-rs / doc-push

Tokio doc blitz effort - A concerted effort to improve Tokio's documentation.
MIT License
50 stars 7 forks source link

Tokio vs Futures intro point #70

Closed AndyGauge closed 6 years ago

AndyGauge commented 6 years ago

https://github.com/tokio-rs/doc-push/issues/68#issuecomment-428614359 and prior discussion:

Sorry to butt in, but I think it would be nice to make a clear distinction about what tokio is versus what futures are. I don't know if it's really the job of tokio to do that kind of education but, as a beginner, learning tokio is the first time I've encountered futures in Rust so clearly defining tokio's relationship to/distinction from futures would be really helpful to me. - @rawmonstar

rylev commented 6 years ago

I think this is important. Putting it in the futures section makes sense since we're talking about futures, but putting something in the runtime section also makes sense since that's a large part of what Tokio is. I'll merge this for now, and we can see how it works out in practice.