Adapt GitHub landing page.
This commit is contained in:
parent
9776cb7593
commit
519e5489ef
49
README.md
49
README.md
|
@ -3,7 +3,9 @@
|
||||||
You've heard about Rust, but you never had the chance to try it out?
|
You've heard about Rust, but you never had the chance to try it out?
|
||||||
This course is for you!
|
This course is for you!
|
||||||
|
|
||||||
You'll go from knowing nothing about Rust to feeling productive on your own in roughly 100 exercises.
|
You'll learn Rust by solving 100 exercises.
|
||||||
|
You'll go from knowing nothing about Rust to being able to start
|
||||||
|
writing your own programs, one exercise at a time.
|
||||||
|
|
||||||
> [!NOTE]
|
> [!NOTE]
|
||||||
> This course has been written by [Mainmatter](https://mainmatter.com/rust-consulting/).
|
> This course has been written by [Mainmatter](https://mainmatter.com/rust-consulting/).
|
||||||
|
@ -11,23 +13,10 @@ You'll go from knowing nothing about Rust to feeling productive on your own in r
|
||||||
> Check out our [landing page](https://mainmatter.com/rust-consulting/) if you're looking for Rust consulting or
|
> Check out our [landing page](https://mainmatter.com/rust-consulting/) if you're looking for Rust consulting or
|
||||||
> training!
|
> training!
|
||||||
|
|
||||||
## Audience
|
## Getting started
|
||||||
|
|
||||||
This course is designed for people who have basic familiarity with at least another programming language
|
Go to [rust-exercises.com](https://rust-exercises.com) and follow the instructions there
|
||||||
(e.g. Python, JavaScript, Java, C++, etc.), but have never written any Rust code before.
|
to get started with the course.
|
||||||
|
|
||||||
Due to the variety of backgrounds, we won't assume any prior knowledge of systems programming or low-level languages.
|
|
||||||
Approach the relevant exercises as a refresher if you've already been exposed to some of those topics in the past!
|
|
||||||
|
|
||||||
## Self-paced
|
|
||||||
|
|
||||||
This course is designed to be delivered by an experienced instructor over 4 days: each attendee advances through the
|
|
||||||
lessons at their own pace, with the instructor providing guidance, answering questions and diving deeper into the topics
|
|
||||||
as needed.
|
|
||||||
As a rule of thumb: if you're stuck on an exercise for more than 10 minutes, ask for help!
|
|
||||||
|
|
||||||
You can also try to go through the course on your own, although we recommend having someone to ask questions to if you
|
|
||||||
get stuck.
|
|
||||||
|
|
||||||
## Requirements
|
## Requirements
|
||||||
|
|
||||||
|
@ -35,38 +24,12 @@ get stuck.
|
||||||
If `rustup` is already installed on your system, run `rustup update` (or another appropriate command depending on how
|
If `rustup` is already installed on your system, run `rustup update` (or another appropriate command depending on how
|
||||||
you installed Rust on your system)
|
you installed Rust on your system)
|
||||||
to make your running on the latest version.
|
to make your running on the latest version.
|
||||||
- `mdbook`, to render the course material.
|
|
||||||
You can install it with `cargo install --locked mdbook`.
|
|
||||||
- _(Optional but recommended)_ An IDE with Rust autocompletion support.
|
- _(Optional but recommended)_ An IDE with Rust autocompletion support.
|
||||||
We recommend one of the following:
|
We recommend one of the following:
|
||||||
- [RustRover](https://www.jetbrains.com/rust/);
|
- [RustRover](https://www.jetbrains.com/rust/);
|
||||||
- [Visual Studio Code](https://code.visualstudio.com) with
|
- [Visual Studio Code](https://code.visualstudio.com) with
|
||||||
the [`rust-analyzer`](https://marketplace.visualstudio.com/items?itemName=matklad.rust-analyzer) extension.
|
the [`rust-analyzer`](https://marketplace.visualstudio.com/items?itemName=matklad.rust-analyzer) extension.
|
||||||
|
|
||||||
## Getting started
|
|
||||||
|
|
||||||
Clone the repository and create a new branch to work on your solutions:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git clone git@github.com:mainmatter/100-exercises-to-learn-rust.git
|
|
||||||
# Or `git clone https://github.com/mainmatter/100-exercises-to-learn-rust.git`
|
|
||||||
# if you haven't set up SSH keys for GitHub
|
|
||||||
|
|
||||||
cd 100-exercises-to-learn-rust
|
|
||||||
git checkout -b my-solutions
|
|
||||||
```
|
|
||||||
|
|
||||||
Then start a local server and view the course material in your browser:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
cd book
|
|
||||||
# It'll open the browser automatically
|
|
||||||
# If it doesn't, open http://localhost:3012 in your browser
|
|
||||||
mdbook serve --port 3012 --open
|
|
||||||
```
|
|
||||||
|
|
||||||
Follow the instructions in the book to get started with the exercises!
|
|
||||||
|
|
||||||
## Solutions
|
## Solutions
|
||||||
|
|
||||||
You can find the solutions to the exercises in
|
You can find the solutions to the exercises in
|
||||||
|
|
Loading…
Reference in New Issue