From 519e5489ef34974abea3f7395425ab49db2938dc Mon Sep 17 00:00:00 2001 From: LukeMathWalker <20745048+LukeMathWalker@users.noreply.github.com> Date: Tue, 14 May 2024 14:22:34 +0200 Subject: [PATCH] Adapt GitHub landing page. --- README.md | 49 ++++++------------------------------------------- 1 file changed, 6 insertions(+), 43 deletions(-) diff --git a/README.md b/README.md index 8b4af07..1c39f9e 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,9 @@ You've heard about Rust, but you never had the chance to try it out? 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] > 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 > training! -## Audience - -This course is designed for people who have basic familiarity with at least another programming language -(e.g. Python, JavaScript, Java, C++, etc.), but have never written any Rust code before. - -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! +## Getting started -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. +Go to [rust-exercises.com](https://rust-exercises.com) and follow the instructions there +to get started with the course. ## 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 you installed Rust on your system) 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. We recommend one of the following: - [RustRover](https://www.jetbrains.com/rust/); - [Visual Studio Code](https://code.visualstudio.com) with 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 You can find the solutions to the exercises in -- 2.45.2