src/doc/index.md

   1 % Rust Documentation
   2
   3 <style>
   4 nav {
   5     display: none;
   6 }
   7 </style>
   8
   9 This page is an overview of the documentation included with your Rust install.
  10 Other unofficial documentation may exist elsewhere; for example, the [Rust
  11 Learning] project collects documentation from the community, and [Docs.rs]
  12 builds documentation for individual Rust packages.
  13
  14 # API Documentation
  15
  16 Rust provides a standard library with a number of features; [we host its
  17 documentation here][api].
  18
  19 # Extended Error Documentation
  20
  21 Many of Rust's errors come with error codes, and you can request extended
  22 diagnostics from the compiler on those errors. We also [have the text of those
  23 extended errors on the web][err], if you prefer to read them that way.
  24
  25 # The Rust Bookshelf
  26
  27 Rust provides a number of book-length sets of documentation, collectively
  28 nicknamed 'The Rust Bookshelf.'
  29
  30 * [The Rust Programming Language][book] teaches you how to program in Rust.
  31 * [The Cargo Book][cargo-book] is a guide to Cargo, Rust's build tool and dependency manager.
  32 * [The Unstable Book][unstable-book] has documentation for unstable features.
  33 * [The Rustonomicon][nomicon] is your guidebook to the dark arts of unsafe Rust.
  34 * [The Reference][ref] is not a formal spec, but is more detailed and comprehensive than the book.
  35 * [The Rustdoc Book][rustdoc-book] describes our documentation tool, `rustdoc`.
  36
  37 Initially, documentation lands in the Unstable Book, and then, as part of the
  38 stabilization process, is moved into the Book, Nomicon, or Reference.
  39
  40 Another few words about the reference: it is guaranteed to be accurate, but not
  41 complete. We have a policy that features must have documentation to be stabilized,
  42 but we did not always have this policy, and so there are some stable things that
  43 are not yet in the reference. We're working on back-filling things that landed
  44 before this policy was put into place. That work is being tracked
  45 [here][refchecklist].
  46
  47 [Rust Learning]: https://github.com/ctjhoa/rust-learning
  48 [Docs.rs]: https://docs.rs/
  49 [api]: std/index.html
  50 [ref]: reference/index.html
  51 [refchecklist]: https://github.com/rust-lang-nursery/reference/issues/9
  52 [err]: error-index.html
  53 [book]: book/index.html
  54 [nomicon]: nomicon/index.html
  55 [unstable-book]: unstable-book/index.html
  56 [rustdoc-book]: rustdoc/index.html
  57 [cargo-book]: cargo/index.html
  58