3 Welcome to the Rust documentation! You can use the section headings above
4 to jump to any particular section.
8 If you haven't seen Rust at all yet, the first thing you should read is the [30
9 minute intro](intro.html). It will give you an overview of the basic ideas of Rust
12 Once you know you really want to learn Rust, the next step is reading [the
13 guide](guide.html). It is a lengthy explanation of Rust, its syntax, and its
14 concepts. Upon completing the guide, you'll be an intermediate Rust developer,
15 and will have a good grasp of the fundamental ideas behind Rust.
17 # Community & Getting Help
19 If you need help with something, or just want to talk about Rust with others,
20 there's a few places you can do that:
22 The Rust IRC channels on [irc.mozilla.org](http://irc.mozilla.org/) are the
23 fastest way to get help.
24 [`#rust`](http://chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust) is
25 the general discussion channel, and you'll find people willing to help you with
26 any questions you may have.
28 There are also three specialty channels:
29 [`#rust-gamedev`](http://chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust-gamedev)
31 [`#rust-osdev`](http://chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust-osdev)
32 are for game development and operating system development, respectively.
34 [`#rust-internals`](http://chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust-internals), which is for discussion of the development of Rust itself.
36 You can also get help on [Stack
37 Overflow](http://stackoverflow.com/questions/tagged/rust). Searching for your
38 problem might reveal someone who has asked it before!
40 There is an active [subreddit](http://reddit.com/r/rust) with lots of
41 discussion about Rust.
43 There is also a [developer forum](http://discuss.rust-lang.org/), where the
44 development of Rust itself is discussed.
48 Rust does not have an exact specification, but an effort to describe as much of
49 the language in as much detail as possible is in [the reference](reference.html).
53 Rust Guides are in-depth looks at a particular topic that's relevant to Rust
54 development. If you're trying to figure out how to do something, there may be
55 a guide that can help you out:
57 * [Ownership](guide-ownership.html)
58 * [Strings](guide-strings.html)
59 * [Pointers](guide-pointers.html)
60 * [Crates and modules](guide-crates.html)
61 * [Tasks and Communication](guide-tasks.html)
62 * [Error Handling](guide-error-handling.html)
63 * [Foreign Function Interface](guide-ffi.html)
64 * [Writing Unsafe and Low-Level Code](guide-unsafe.html)
65 * [Macros](guide-macros.html)
66 * [Testing](guide-testing.html)
67 * [Compiler Plugins](guide-plugin.html)
71 Rust's still a young language, so there isn't a ton of tooling yet, but the
72 tools we have are really nice.
74 [Cargo](http://crates.io) is Rust's package manager, and its website contains
75 lots of good documentation.
77 [The `rustdoc` manual](rustdoc.html) contains information about Rust's
82 There are questions that are asked quite often, and so we've made FAQs for them:
84 * [Language Design FAQ](complement-design-faq.html)
85 * [Language FAQ](complement-lang-faq.html)
86 * [Project FAQ](complement-project-faq.html)
87 * [How to submit a bug report](complement-bugreport.html)
89 # The standard library
91 We have [API documentation for the entire standard
92 library](std/index.html). There's a list of crates on the left with more
93 specific sections, or you can use the search bar at the top to search for
94 something if you know its name.
96 # External documentation
98 *Note: While these are great resources for learning Rust, they may track a
99 particular version of Rust that is likely not exactly the same as that for
100 which this documentation was generated.*
102 * [Rust by Example] - Short examples of common tasks in Rust (tracks the master
104 * [Rust for Rubyists] - The first community tutorial for Rust. Tracks the last
105 stable release. Not just for Ruby programmers.
107 [Rust by Example]: http://rustbyexample.com/
108 [Rust for Rubyists]: http://www.rustforrubyists.com/