rust/src/doc/index.md

66 lines
2.2 KiB
Markdown
Raw Normal View History

% Rust Documentation
2014-08-28 14:52:39 -04:00
Welcome to the Rust documentation! You can use the section headings above
to jump to any particular section.
# Getting Started
2015-05-08 13:18:04 -07:00
If you haven't seen Rust at all yet, the first thing you should read is the
introduction to [The Rust Programming Language](book/index.html). It'll give
you a good idea of what Rust is like.
The book provides a lengthy explanation of Rust, its syntax, and its
concepts. Upon completing the book, you'll be an intermediate Rust
developer, and will have a good grasp of the fundamental ideas behind
Rust.
2014-08-28 14:52:39 -04:00
2015-11-03 12:47:57 -08:00
[Rust By Example][rbe] teaches you Rust through a series of small
examples.
2015-04-15 12:58:00 -05:00
[rbe]: http://rustbyexample.com/
2015-09-06 16:07:55 +03:00
# Language Reference
2015-09-06 15:25:01 +03:00
2015-09-06 16:07:55 +03:00
Rust does not have an exact specification yet, but an effort to describe as much of
2015-09-06 15:25:01 +03:00
the language in as much detail as possible is in [the reference](reference.html).
2015-09-06 16:07:55 +03:00
# Standard Library Reference
We have [API documentation for the entire standard
library](std/index.html). There's a list of crates on the left with more
specific sections, or you can use the search bar at the top to search for
something if you know its name.
2015-09-06 15:25:01 +03:00
# Tools
2015-09-06 16:07:55 +03:00
[Cargo](https://crates.io) is the Rust's package manager providing access to libraries
beyond the standard one, and its website contains lots of good documentation.
2015-09-06 15:25:01 +03:00
2015-09-06 16:07:55 +03:00
[`rustdoc`](book/documentation.html) is the Rust's documentation generator, a tool converting
annotated source code into HTML docs.
2015-09-06 15:25:01 +03:00
# FAQs
There are questions that are asked quite often, so we've made FAQs for them:
2014-08-28 14:52:39 -04:00
* [Language Design FAQ](complement-design-faq.html)
* [Language FAQ](complement-lang-faq.html)
* [Project FAQ](complement-project-faq.html)
* [How to submit a bug report](https://github.com/rust-lang/rust/blob/master/CONTRIBUTING.md#bug-reports)
# The Error Index
If you encounter an error while compiling your code you may be able to look it
up in the [Rust Compiler Error Index](error-index.html).
2015-05-24 11:37:11 -04:00
# Community Translations
Several projects have been started to translate the documentation into other
languages:
- [Russian](https://github.com/kgv/rust_book_ru)
- [Korean](https://github.com/rust-kr/doc.rust-kr.org)
- [Chinese](https://github.com/KaiserY/rust-book-chinese)
- [Spanish](https://goyox86.github.io/elpr)
- [German](https://panicbit.github.io/rustbook-de)