docs(exercises): consistent exercise description

exercises/if/if1.rs

@@ -1,9 +1,13 @@
 // if1.rs
+//
+// Make me compile!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint if1
 
 // I AM NOT DONE
 
 pub fn bigger(a: i32, b: i32) -> i32 {
-    // Complete this function to return the bigger number!
+    // TODO: Complete this function to return the bigger number!
     // Do not use:
     // - another function call
     // - additional variables

exercises/if/if2.rs

@@ -1,8 +1,9 @@
 // if2.rs
-
+//
 // Step 1: Make me compile!
 // Step 2: Get the bar_for_fuzz and default_to_baz tests passing!
-// Execute the command `rustlings hint if2` if you want a hint :)
+//
+// If you need help, open the corresponding README.md or run: rustlings hint if2
 
 // I AM NOT DONE
 

exercises/macros/macros1.rs

@@ -1,5 +1,8 @@
 // macros1.rs
-// Make me compile! Execute `rustlings hint macros1` for hints :)
+//
+// Make me compile!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint macros1
 
 // I AM NOT DONE
 

exercises/macros/macros2.rs

@@ -1,5 +1,8 @@
 // macros2.rs
-// Make me compile! Execute `rustlings hint macros2` for hints :)
+//
+// Make me compile!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint macros2
 
 // I AM NOT DONE
 

exercises/macros/macros3.rs

@@ -1,6 +1,8 @@
 // macros3.rs
+//
 // Make me compile, without taking the macro out of the module!
-// Execute `rustlings hint macros3` for hints :)
+//
+// If you need help, open the corresponding README.md or run: rustlings hint macros3
 
 // I AM NOT DONE
 

exercises/macros/macros4.rs

@@ -1,5 +1,8 @@
 // macros4.rs
-// Make me compile! Execute `rustlings hint macros4` for hints :)
+//
+// Make me compile!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint macros4
 
 // I AM NOT DONE
 

exercises/modules/modules1.rs

@@ -1,5 +1,8 @@
 // modules1.rs
-// Make me compile! Execute `rustlings hint modules1` for hints :)
+//
+// Make me compile!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint modules1
 
 // I AM NOT DONE
 

exercises/modules/modules2.rs

@@ -1,5 +1,8 @@
 // modules2.rs
-// Make me compile! Execute `rustlings hint modules2` for hints :)
+//
+// Make me compile!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint modules2
 
 // I AM NOT DONE
 

exercises/move_semantics/move_semantics1.rs

@@ -1,5 +1,8 @@
 // move_semantics1.rs
-// Make me compile! Execute `rustlings hint move_semantics1` for hints :)
+//
+// Make me compile!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint move_semantics1
 
 // I AM NOT DONE
 

exercises/move_semantics/move_semantics2.rs

@@ -1,6 +1,8 @@
 // move_semantics2.rs
+//
 // Make me compile without changing line 13!
-// Execute `rustlings hint move_semantics2` for hints :)
+//
+// If you need help, open the corresponding README.md or run: rustlings hint move_semantics2
 
 // I AM NOT DONE
 

exercises/move_semantics/move_semantics3.rs

@@ -1,7 +1,9 @@
 // move_semantics3.rs
+//
 // Make me compile without adding new lines-- just changing existing lines!
 // (no lines with multiple semicolons necessary!)
-// Execute `rustlings hint move_semantics3` for hints :)
+//
+// If you need help, open the corresponding README.md or run: rustlings hint move_semantics3
 
 // I AM NOT DONE
 

exercises/move_semantics/move_semantics4.rs

@@ -1,8 +1,10 @@
 // move_semantics4.rs
+//
 // Refactor this code so that instead of having `vec0` and creating the vector
 // in `fn main`, we create it within `fn fill_vec` and transfer the
 // freshly created vector from fill_vec to its caller.
-// Execute `rustlings hint move_semantics4` for hints!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint move_semantics4
 
 // I AM NOT DONE
 

exercises/option/option1.rs

@@ -1,9 +1,12 @@
 // option1.rs
-// Make me compile! Execute `rustlings hint option1` for hints
+//
+// Make me compile!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint option1
 
 // I AM NOT DONE
 
-// you can modify anything EXCEPT for this function's sig
+// You can modify anything EXCEPT for this function's sig
 fn print_number(maybe_number: Option<u16>) {
     println!("printing: {}", maybe_number.unwrap());
 }

exercises/option/option2.rs

@@ -1,5 +1,8 @@
 // option2.rs
-// Make me compile! Execute `rustlings hint option2` for hints
+//
+// Make me compile!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint option2
 
 // I AM NOT DONE
 

exercises/primitive_types/primitive_types1.rs

@@ -1,6 +1,9 @@
 // primitive_types1.rs
+//
 // Fill in the rest of the line that has code missing!
 // No hints, there's no tricks, just get used to typing these :)
+//
+// If you need help, open the corresponding README.md
 
 // I AM NOT DONE
 

exercises/primitive_types/primitive_types2.rs

@@ -1,6 +1,9 @@
 // primitive_types2.rs
+//
 // Fill in the rest of the line that has code missing!
 // No hints, there's no tricks, just get used to typing these :)
+//
+// If you need help, open the corresponding README.md
 
 // I AM NOT DONE
 

exercises/primitive_types/primitive_types3.rs

@@ -1,6 +1,8 @@
 // primitive_types3.rs
+//
 // Create an array with at least 100 elements in it where the ??? is.
-// Execute `rustlings hint primitive_types3` for hints!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint primitive_types3
 
 // I AM NOT DONE
 

exercises/primitive_types/primitive_types4.rs

@@ -1,6 +1,8 @@
 // primitive_types4.rs
+//
 // Get a slice out of Array a where the ??? is so that the test passes.
-// Execute `rustlings hint primitive_types4` for hints!!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint primitive_types4
 
 // I AM NOT DONE
 

exercises/primitive_types/primitive_types5.rs

@@ -1,6 +1,8 @@
 // primitive_types5.rs
+//
 // Destructure the `cat` tuple so that the println will work.
-// Execute `rustlings hint primitive_types5` for hints!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint primitive_types5
 
 // I AM NOT DONE
 

exercises/primitive_types/primitive_types6.rs

@@ -1,7 +1,9 @@
 // primitive_types6.rs
+//
 // Use a tuple index to access the second element of `numbers`.
 // You can put the expression for the second element where ??? is so that the test passes.
-// Execute `rustlings hint primitive_types6` for hints!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint primitive_types6
 
 // I AM NOT DONE
 

exercises/quiz1.rs

@@ -1,18 +1,21 @@
 // quiz1.rs
-// This is a quiz for the following sections:
+//
+// This quiz covers the sections:
 // - Variables
 // - Functions
-
+//
 // Mary is buying apples. One apple usually costs 2 Rustbucks, but if you buy
 // more than 40 at once, each apple only costs 1! Write a function that calculates
-// the price of an order of apples given the order amount. No hints this time!
+// the price of an order of apples given the order amount.
+//
+// No hints this time :)
 
 // I AM NOT DONE
 
 // Put your function here!
 // fn ..... {
 
-// Don't modify this function!
+// Don't modify this test function!
 #[test]
 fn verify_test() {
     let price1 = calculate_apple_price(35);

exercises/quiz2.rs

@@ -1,11 +1,14 @@
 // quiz2.rs
-// This is a quiz for the following sections:
+//
+// This quiz covers the sections:
 // - Strings
-
+//
 // Ok, here are a bunch of values-- some are `String`s, some are `&str`s. Your
 // task is to call one of these two functions on each value depending on what
 // you think each value is. That is, add either `string_slice` or `string`
 // before the parentheses on each line. If you're right, it will compile!
+//
+// No hints this time :)
 
 // I AM NOT DONE
 

exercises/quiz3.rs

@@ -1,11 +1,13 @@
 // quiz3.rs
-// This is a quiz for the following sections:
+//
+// This quiz covers the sections:
 // - Tests
-
+//
 // This quiz isn't testing our function -- make it do that in such a way that
 // the test passes. Then write a second test that tests that we get the result
 // we expect to get when we call `times_two` with a negative number.
-// No hints, you can do this :)
+//
+// No hints this time :)
 
 // I AM NOT DONE
 
@@ -24,7 +26,7 @@ mod tests {
 
     #[test]
     fn returns_twice_of_negative_numbers() {
-        // TODO replace unimplemented!() with an assert for `times_two(-4)`
+        // TODO: replace unimplemented!() with an assert for `times_two(-4)`
         unimplemented!()
     }
 }

exercises/quiz4.rs

@@ -1,9 +1,12 @@
 // quiz4.rs
+//
 // This quiz covers the sections:
 // - Modules
 // - Macros
-
+//
 // Write a macro that passes the quiz! No hints this time, you can do it!
+//
+// No hints this time :)
 
 // I AM NOT DONE
 

exercises/standard_library_types/arc1.rs

@@ -1,4 +1,5 @@
 // arc1.rs
+//
 // In this exercise, we are given a Vec of u32 called "numbers" with values ranging
 // from 0 to 99 -- [ 0, 1, 2, ..., 98, 99 ]
 // We would like to use this set of numbers within 8 different threads simultaneously.
@@ -8,15 +9,15 @@
 // The third thread (offset 2), will sum 2, 10, 18, ...
 // ...
 // The eighth thread (offset 7), will sum 7, 15, 23, ...
-
+//
 // Because we are using threads, our values need to be thread-safe.  Therefore,
 // we are using Arc.  We need to make a change in each of the two TODOs.
-
+//
-
 // Make this code compile by filling in a value for `shared_numbers` where the
 // first TODO comment is, and create an initial binding for `child_numbers`
 // where the second TODO comment is. Try not to create any copies of the `numbers` Vec!
-// Execute `rustlings hint arc1` for hints :)
+//
+// If you need help, open the corresponding README.md or run: rustlings hint arc1
 
 // I AM NOT DONE
 

exercises/standard_library_types/box1.rs

@@ -14,7 +14,7 @@
 //
 // Note: the tests should not be changed
 //
-// Execute `rustlings hint box1` for hints :)
+// If you need help, open the corresponding README.md or run: rustlings hint box1
 
 // I AM NOT DONE
 

exercises/standard_library_types/iterators1.rs

@@ -6,7 +6,7 @@
 // This module helps you get familiar with the structure of using an iterator and 
 // how to go through elements within an iterable collection.
 // 
-// Execute `rustlings hint iterators1` for hints :D
+// If you need help, open the corresponding README.md or run: rustlings hint iterators1
 
 // I AM NOT DONE
 

exercises/standard_library_types/iterators2.rs

@@ -1,7 +1,9 @@
 // iterators2.rs
+//
 // In this exercise, you'll learn some of the unique advantages that iterators
 // can offer. Follow the steps to complete the exercise.
-// As always, there are hints if you execute `rustlings hint iterators2`!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint iterators2
 
 // I AM NOT DONE
 

exercises/standard_library_types/iterators3.rs

@@ -1,10 +1,12 @@
 // iterators3.rs
+//
 // This is a bigger exercise than most of the others! You can do it!
 // Here is your mission, should you choose to accept it:
 // 1. Complete the divide function to get the first four tests to pass.
 // 2. Get the remaining tests to pass by completing the result_with_list and
 //    list_of_results functions.
-// Execute `rustlings hint iterators3` to get some hints!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint iterators3
 
 // I AM NOT DONE
 

exercises/standard_library_types/iterators4.rs

@@ -1,9 +1,13 @@
 // iterators4.rs
+//
+// Make the tests pass!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint iterators4
 
 // I AM NOT DONE
 
 pub fn factorial(num: u64) -> u64 {
-    // Complete this function to return the factorial of num
+    // TODO: Complete this function to return the factorial of num
     // Do not use:
     // - return
     // Try not to use:

exercises/standard_library_types/iterators5.rs

@@ -1,5 +1,5 @@
 // iterators5.rs
-
+//
 // Let's define a simple model to track Rustlings exercise progress. Progress
 // will be modelled using a hash map. The name of the exercise is the key and
 // the progress is the value. Two counting functions were created to count the
@@ -7,10 +7,10 @@
 // imperative style for loops. Recreate this counting functionality using
 // iterators. Only the two iterator methods (count_iterator and
 // count_collection_iterator) need to be modified.
-// Execute `rustlings hint
-// iterators5` for hints.
 //
 // Make the code compile and the tests pass.
+//
+// If you need help, open the corresponding README.md or run: rustlings hint iterators5
 
 // I AM NOT DONE
 

exercises/strings/strings1.rs

@@ -1,6 +1,8 @@
 // strings1.rs
+//
 // Make me compile without changing the function signature!
-// Execute `rustlings hint strings1` for hints ;)
+//
+// If you need help, open the corresponding README.md or run: rustlings hint strings1
 
 // I AM NOT DONE
 

exercises/strings/strings2.rs

@@ -1,6 +1,8 @@
 // strings2.rs
+//
 // Make me compile without changing the function signature!
-// Execute `rustlings hint strings2` for hints :)
+//
+// If you need help, open the corresponding README.md or run: rustlings hint strings2
 
 // I AM NOT DONE
 

exercises/structs/structs1.rs

@@ -1,5 +1,8 @@
 // structs1.rs
+//
 // Address all the TODOs to make the tests pass!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint structs1
 
 // I AM NOT DONE
 

exercises/structs/structs2.rs

@@ -1,5 +1,8 @@
 // structs2.rs
+//
 // Address all the TODOs to make the tests pass!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint structs2
 
 // I AM NOT DONE
 

exercises/structs/structs3.rs

@@ -1,8 +1,10 @@
 // structs3.rs
+//
 // Structs contain data, but can also have logic. In this exercise we have
 // defined the Package struct and we want to test some logic attached to it.
 // Make the code compile and the tests pass!
-// If you have issues execute `rustlings hint structs3`
+//
+// If you need help, open the corresponding README.md or run: rustlings hint structs3
 
 // I AM NOT DONE
 

exercises/tests/tests1.rs

@@ -1,10 +1,13 @@
 // tests1.rs
+//
 // Tests are important to ensure that your code does what you think it should do.
 // Tests can be run on this file with the following command:
 // rustlings run tests1
-
+//
 // This test has a problem with it -- make the test compile! Make the test
-// pass! Make the test fail! Execute `rustlings hint tests1` for hints :)
+// pass! Make the test fail!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint tests1
 
 // I AM NOT DONE
 

exercises/tests/tests2.rs

@@ -1,6 +1,9 @@
 // tests2.rs
+//
 // This test has a problem with it -- make the test compile! Make the test
-// pass! Make the test fail! Execute `rustlings hint tests2` for hints :)
+// pass! Make the test fail!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint tests2
 
 // I AM NOT DONE
 

exercises/tests/tests3.rs

@@ -1,8 +1,10 @@
 // tests3.rs
+//
 // This test isn't testing our function -- make it do that in such a way that
 // the test passes. Then write a second test that tests whether we get the result
 // we expect to get when we call `is_even(5)`.
-// Execute `rustlings hint tests3` for hints :)
+//
+// If you need help, open the corresponding README.md or run: rustlings hint tests3
 
 // I AM NOT DONE
 

exercises/threads/threads1.rs

@@ -1,10 +1,13 @@
 // threads1.rs
-// Make this compile! Execute `rustlings hint threads1` for hints :)
+//
 // The idea is the thread spawned on line 22 is completing jobs while the main thread is
 // monitoring progress until 10 jobs are completed. Because of the difference between the
 // spawned threads' sleep time, and the waiting threads sleep time, when you see 6 lines
 // of "waiting..." and the program ends without timing out when running,
 // you've got it :)
+// Make me compile!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint threads1
 
 // I AM NOT DONE
 

exercises/traits/traits1.rs

@@ -1,4 +1,5 @@
 // traits1.rs
+//
 // Time to implement some traits!
 //
 // Your task is to implement the trait
@@ -7,6 +8,8 @@
 // The trait AppendBar has only one function,
 // which appends "Bar" to any object
 // implementing this trait.
+//
+// If you need help, open the corresponding README.md or run: rustlings hint traits1
 
 // I AM NOT DONE
 

exercises/traits/traits2.rs

@@ -9,6 +9,8 @@
 //
 // No boiler plate code this time,
 // you can do this!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint traits2
 
 // I AM NOT DONE
 

exercises/variables/variables1.rs

@@ -1,10 +1,12 @@
 // variables1.rs
-// Make me compile! Execute the command `rustlings hint variables1` if you want a hint :)
+//
-
 // About this `I AM NOT DONE` thing:
 // We sometimes encourage you to keep trying things on a given exercise,
 // even after you already figured it out. If you got everything working and
 // feel ready for the next exercise, remove the `I AM NOT DONE` comment below.
+// Make me compile!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint variables1
 
 // I AM NOT DONE
 

exercises/variables/variables2.rs

@@ -1,5 +1,8 @@
 // variables2.rs
-// Make me compile! Execute the command `rustlings hint variables2` if you want a hint :)
+//
+// Make me compile!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint variables2
 
 // I AM NOT DONE
 

exercises/variables/variables3.rs

@@ -1,5 +1,8 @@
 // variables3.rs
-// Make me compile! Execute the command `rustlings hint variables3` if you want a hint :)
+//
+// Make me compile!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint variables3
 
 // I AM NOT DONE
 

exercises/variables/variables4.rs

@@ -1,5 +1,8 @@
 // variables4.rs
-// Make me compile! Execute the command `rustlings hint variables4` if you want a hint :)
+//
+// Make me compile!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint variables4
 
 // I AM NOT DONE
 

exercises/variables/variables5.rs

@@ -1,5 +1,8 @@
 // variables5.rs
-// Make me compile! Execute the command `rustlings hint variables5` if you want a hint :)
+//
+// Make me compile!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint variables5
 
 // I AM NOT DONE
 

exercises/variables/variables6.rs

@@ -1,5 +1,8 @@
 // variables6.rs
-// Make me compile! Execute the command `rustlings hint variables6` if you want a hint :)
+//
+// Make me compile!
+//
+// If you need help, open the corresponding README.md or run: rustlings hint variables6
 
 // I AM NOT DONE