rust/src/doc/trpl/README.md
Steve Klabnik 16a6ebd1f6 "The Rust Programming Language"
This pulls all of our long-form documentation into a single document,
nicknamed "the book" and formally titled "The Rust Programming
Language."

A few things motivated this change:

* People knew of The Guide, but not the individual Guides. This merges
  them together, helping discoverability.
* You can get all of Rust's longform documentation in one place, which
  is nice.
* We now have rustbook in-tree, which can generate this kind of
  documentation. While its style is basic, the general idea is much
  better: a table of contents on the left-hand side.
* Rather than a almost 10,000-line guide.md, there are now smaller files
  per section.
2015-01-08 12:02:11 -05:00

1.3 KiB

% The Rust Programming Language

Welcome! This book will teach you about the Rust Programming Language. Rust is a modern systems programming language focusing on safety and speed. It accomplishes these goals by being memory safe without using garbage collection.

"The Rust Programming Language" is split into three sections, which you can navigate through the menu on the left.

Basics

This section is a linear introduction to the basic syntax and semantics of Rust. It has individual sections on each part of Rust's syntax, and cumulates in a small project: a guessing game.

After reading "Basics," you will have a good foundation to learn more about Rust, and can write very simple programs.

Intermediate

This section contains individual chapters, which are self-contained. They focus on specific topics, and can be read in any order.

After reading "Intermediate," you will have a solid understanding of Rust, and will be able to understand most Rust code and write more complex programs.

Advanced

In a similar fashion to "Intermediate," this setion is full of individual, deep-dive chapters, which stand alone and can be read in any order. These chapters focus on the most complex features, as well as some things that are only available in upcoming versions of Rust.

After reading "Advanced," you'll be a Rust expert!