| 1 | <div align="center"> |
| 2 | <picture> |
| 3 | <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/rust-lang/www.rust-lang.org/master/static/images/rust-social-wide-dark.svg"> |
| 4 | <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/rust-lang/www.rust-lang.org/master/static/images/rust-social-wide-light.svg"> |
| 5 | <img alt="The Rust Programming Language: A language empowering everyone to build reliable and efficient software" |
| 6 | src="https://raw.githubusercontent.com/rust-lang/www.rust-lang.org/master/static/images/rust-social-wide-light.svg" |
| 7 | width="50%"> |
| 8 | </picture> |
| 9 | |
| 10 | [Website][Rust] | [Getting started] | [Learn] | [Documentation] | [Contributing] |
| 11 | </div> |
| 12 | |
| 13 | This is the main source code repository for [Rust]. It contains the compiler, |
| 14 | standard library, and documentation. |
| 15 | |
| 16 | [Rust]: https://www.rust-lang.org/ |
| 17 | [Getting Started]: https://www.rust-lang.org/learn/get-started |
| 18 | [Learn]: https://www.rust-lang.org/learn |
| 19 | [Documentation]: https://www.rust-lang.org/learn#learn-use |
| 20 | [Contributing]: CONTRIBUTING.md |
| 21 | |
| 22 | ## Why Rust? |
| 23 | |
| 24 | - **Performance:** Fast and memory-efficient, suitable for critical services, embedded devices, and easily integrated with other languages. |
| 25 | |
| 26 | - **Reliability:** Our rich type system and ownership model ensure memory and thread safety, reducing bugs at compile-time. |
| 27 | |
| 28 | - **Productivity:** Comprehensive documentation, a compiler committed to providing great diagnostics, and advanced tooling including package manager and build tool ([Cargo]), auto-formatter ([rustfmt]), linter ([Clippy]) and editor support ([rust-analyzer]). |
| 29 | |
| 30 | [Cargo]: https://github.com/rust-lang/cargo |
| 31 | [rustfmt]: https://github.com/rust-lang/rustfmt |
| 32 | [Clippy]: https://github.com/rust-lang/rust-clippy |
| 33 | [rust-analyzer]: https://github.com/rust-lang/rust-analyzer |
| 34 | |
| 35 | ## Quick Start |
| 36 | |
| 37 | Read ["Installation"] from [The Book]. |
| 38 | |
| 39 | ["Installation"]: https://doc.rust-lang.org/book/ch01-01-installation.html |
| 40 | [The Book]: https://doc.rust-lang.org/book/index.html |
| 41 | |
| 42 | ## Installing from Source |
| 43 | |
| 44 | If you really want to install from source (though this is not recommended), see |
| 45 | [INSTALL.md](INSTALL.md). |
| 46 | |
| 47 | ## Getting Help |
| 48 | |
| 49 | See https://www.rust-lang.org/community for a list of chat platforms and forums. |
| 50 | |
| 51 | ## Contributing |
| 52 | |
| 53 | See [CONTRIBUTING.md](CONTRIBUTING.md). |
| 54 | |
| 55 | For a detailed explanation of the compiler's architecture and how to begin contributing, see the [rustc-dev-guide](https://rustc-dev-guide.rust-lang.org/). |
| 56 | |
| 57 | ## License |
| 58 | |
| 59 | Rust is primarily distributed under the terms of both the MIT license and the |
| 60 | Apache License (Version 2.0), with portions covered by various BSD-like |
| 61 | licenses. |
| 62 | |
| 63 | See [LICENSE-APACHE](LICENSE-APACHE), [LICENSE-MIT](LICENSE-MIT), and |
| 64 | [COPYRIGHT](COPYRIGHT) for details. |
| 65 | |
| 66 | ## Trademark |
| 67 | |
| 68 | [The Rust Foundation][rust-foundation] owns and protects the Rust and Cargo |
| 69 | trademarks and logos (the "Rust Trademarks"). |
| 70 | |
| 71 | If you want to use these names or brands, please read the |
| 72 | [Rust language trademark policy][trademark-policy]. |
| 73 | |
| 74 | Third-party logos may be subject to third-party copyrights and trademarks. See |
| 75 | [Licenses][policies-licenses] for details. |
| 76 | |
| 77 | [rust-foundation]: https://rustfoundation.org/ |
| 78 | [trademark-policy]: https://rustfoundation.org/policy/rust-trademark-policy/ |
| 79 | [policies-licenses]: https://www.rust-lang.org/policies/licenses |