Confusing in building-runtime.

[shaitao]

In this section building-runtime, I don't understand what's talking about. what's default ,Global state and thread-local variable,how it works?

[carllerche]

cc @vorner any thoughts?

[vorner]

Um, I don't really understand what the problem is.

I mean, this guide is kind of dense and expects you already know a lot (like, how to use tokio). But I'm not sure if what you're getting at is that there are technical terms not introduced or that the language is complex…

Or I just don't see what's wrong, maybe because I've written it :-(.

[shaitao]

Um, I don't really understand what the problem is.

I mean, this guide is kind of dense and expects you already know a lot (like, how to use tokio). But I'm not sure if what you're getting at is that there are technical terms not introduced or that the language is complex…

Or I just don't see what's wrong, maybe because I've written it :-(.

Now I realize that the problem is the lack of relevant knowledge, I think Async in Rust: what you need to know will help people like me, I'm waiting it.

[carllerche]

@vorner I think, in general, the runtime guide should be moved to the internals section. I believe there is an open issue for this. What do you think?

[vorner]

I admit, I haven't paid attention much to how the docs changed over time, but yes, I think internals sounds about right. And maybe stating that this part is kind of advanced.

Anyway, would linking to eg. parts of documentation (to rusts thread local storage, to Handle::default()) also help?