doc-push icon indicating copy to clipboard operation
doc-push copied to clipboard

Confusing in building-runtime.

Open shaitao opened this issue 7 years ago • 5 comments

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?

shaitao avatar Oct 15 '18 08:10 shaitao

cc @vorner any thoughts?

carllerche avatar Oct 15 '18 23:10 carllerche

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 :-(.

vorner avatar Oct 17 '18 15:10 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 :-(.

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.

shaitao avatar Oct 17 '18 16:10 shaitao

@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?

carllerche avatar Oct 17 '18 20:10 carllerche

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?

vorner avatar Oct 18 '18 07:10 vorner