summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README.md8
-rw-r--r--exercises/error_handling/README.md5
-rw-r--r--exercises/functions/REAMDE.md1
-rw-r--r--exercises/if/REAMDE.md1
-rw-r--r--exercises/macros/README.md2
-rw-r--r--exercises/modules/README.md1
-rw-r--r--exercises/move_semantics/README.md7
-rw-r--r--exercises/primitive_types/README.md0
-rw-r--r--exercises/standard_library_types/README.md1
-rw-r--r--exercises/strings/REAMDE.md0
-rw-r--r--exercises/tests/README.md3
-rw-r--r--exercises/threads/README.md1
-rw-r--r--exercises/variables/README.md0
13 files changed, 26 insertions, 4 deletions
diff --git a/README.md b/README.md
index dfd48f6..849848f 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
# rustlings
-Greetings and welcome to rustlings. This project contains small exercises get you used to reading and writing code. This includes reading and responding to compiler messages!
+Greetings and welcome to rustlings. This project contains small exercises to get you used to reading and writing code. This includes reading and responding to compiler messages!
## How to get started
To use rustlings you have to have [rust](https://www.rust-lang.org/) installed on your machine.
@@ -13,12 +13,12 @@ by running `cargo install --path <path to the rustlings repo>`
(NOTE: for rustling to function you have to be in the directory of the repo).
## Doing exercises
-The execises are sorted by topic and can be found in the subdirectory `rustlings/exercises/<topic>`. For every topic there is an additional README file with some reasources to get you started on the topic. We really recommend, that you have a look at them before you start.
+The exercises are sorted by topic and can be found in the subdirectory `rustlings/exercises/<topic>`. For every topic there is an additional README file with some resources to get you started on the topic. We really recommend, that you have a look at them before you start.
Your task is simple every exercise contains an error you have to solve, in order to make it compile.
Running rustlings with the subcommand `verify` will compile every exercise in the recommended order. It will stop at the first exercise that didn't compile and show you the error to be solved.
-If you want to run a single erxercise you can use the subcommand `run <path to the exercise>`.
+If you want to run a single exercise, you can use the subcommand `run <path to the exercise>`.
-When you struggle to solve the error, there is usually a tip at the bottom of the each exercise. \ No newline at end of file
+When you struggle to solve the error, there is usually a tip at the bottom of each exercise. \ No newline at end of file
diff --git a/exercises/error_handling/README.md b/exercises/error_handling/README.md
new file mode 100644
index 0000000..b5895d7
--- /dev/null
+++ b/exercises/error_handling/README.md
@@ -0,0 +1,5 @@
+For this exercise check out the chapters:
+- [Error Handling](https://doc.rust-lang.org/book/second-edition/ch09-02-recoverable-errors-with-result.html)
+- [Generics](https://doc.rust-lang.org/book/second-edition/ch10-01-syntax.html)
+
+of the Rust Book. \ No newline at end of file
diff --git a/exercises/functions/REAMDE.md b/exercises/functions/REAMDE.md
new file mode 100644
index 0000000..12bbc05
--- /dev/null
+++ b/exercises/functions/REAMDE.md
@@ -0,0 +1 @@
+For this exercise check out the chapter [Functions](https://doc.rust-lang.org/book/second-edition/ch03-03-how-functions-work.html) of the Rust Book. \ No newline at end of file
diff --git a/exercises/if/REAMDE.md b/exercises/if/REAMDE.md
new file mode 100644
index 0000000..ce68a43
--- /dev/null
+++ b/exercises/if/REAMDE.md
@@ -0,0 +1 @@
+For this exercise check out the chapter [If](https://doc.rust-lang.org/book/second-edition/ch03-05-control-flow.html) of the Rust Book. \ No newline at end of file
diff --git a/exercises/macros/README.md b/exercises/macros/README.md
new file mode 100644
index 0000000..9af0071
--- /dev/null
+++ b/exercises/macros/README.md
@@ -0,0 +1,2 @@
+For this exercise check out the section [Macros](https://doc.rust-lang.org/book/first-edition/macros.html) and the chapter
+[Macros Appendix](https://doc.rust-lang.org/book/2018-edition/appendix-04-macros.html) of the Rust Book and [The Little Book of Rust Macros](https://danielkeep.github.io/tlborm/book/index.html).
diff --git a/exercises/modules/README.md b/exercises/modules/README.md
new file mode 100644
index 0000000..61edccb
--- /dev/null
+++ b/exercises/modules/README.md
@@ -0,0 +1 @@
+For this exercise check out the [Modules](https://doc.rust-lang.org/book/second-edition/ch07-01-mod-and-the-filesystem.html) chapter of the Rust Book. \ No newline at end of file
diff --git a/exercises/move_semantics/README.md b/exercises/move_semantics/README.md
new file mode 100644
index 0000000..d9c6c65
--- /dev/null
+++ b/exercises/move_semantics/README.md
@@ -0,0 +1,7 @@
+These exercises are adapted from [pnkfelix](https://github.com/rustlings/rustlings/blob/master)'s [Rust Tutorial](https://pnkfelix.github.io/rust-examples-icfp2014/) -- Thank you Felix!!!
+
+For this exercise check out the chapters:
+- [Ownership](https://doc.rust-lang.org/book/second-edition/ch04-01-what-is-ownership.html)
+- [Reference and borrowing](https://doc.rust-lang.org/book/second-edition/ch04-02-references-and-borrowing.ht)
+
+of the Rust Book. \ No newline at end of file
diff --git a/exercises/primitive_types/README.md b/exercises/primitive_types/README.md
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/exercises/primitive_types/README.md
diff --git a/exercises/standard_library_types/README.md b/exercises/standard_library_types/README.md
new file mode 100644
index 0000000..ef4ba45
--- /dev/null
+++ b/exercises/standard_library_types/README.md
@@ -0,0 +1 @@
+For this exercise check out the chapter [Shared-State Concurrency](https://doc.rust-lang.org/book/second-edition/ch16-03-shared-state.html) of the Rust Book. \ No newline at end of file
diff --git a/exercises/strings/REAMDE.md b/exercises/strings/REAMDE.md
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/exercises/strings/REAMDE.md
diff --git a/exercises/tests/README.md b/exercises/tests/README.md
new file mode 100644
index 0000000..9919995
--- /dev/null
+++ b/exercises/tests/README.md
@@ -0,0 +1,3 @@
+Going out of order from the book to cover tests -- many of the following exercises will ask you to make tests pass!
+
+For this exercise check out the section [How to Write Tests](https://doc.rust-lang.org/book/second-edition/ch11-01-writing-tests.html) of the Rust Book. \ No newline at end of file
diff --git a/exercises/threads/README.md b/exercises/threads/README.md
new file mode 100644
index 0000000..6e7d789
--- /dev/null
+++ b/exercises/threads/README.md
@@ -0,0 +1 @@
+For this exercise check out the [Dining Philosophers example](https://doc.rust-lang.org/1.4.0/book/dining-philosophers.html) and the chapter [Concurrency](https://doc.rust-lang.org/book/second-edition/ch16-01-threads.html) of the Rust Book. \ No newline at end of file
diff --git a/exercises/variables/README.md b/exercises/variables/README.md
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/exercises/variables/README.md