From 02001b4d4547e8befd44a959ea9936c51d348c21 Mon Sep 17 00:00:00 2001
From: Ray <java4life@gmail.com>
Date: Sun, 28 Feb 2021 08:39:11 +0100
Subject: [PATCH 01/60] Added a detailed tutorial for the breakout game to the
 Bevy book.

---
 content/learn/book/contributing/_index.md     |   2 +-
 content/learn/book/faq/_index.md              |   2 +-
 content/learn/book/next-steps/_index.md       |   2 +-
 content/learn/book/troubleshooting/_index.md  |   2 +-
 content/learn/book/your-first-game/_index.md  | 688 ++++++++++++++++++
 .../learn/book/your-first-game/breakout1.png  | Bin 0 -> 8453 bytes
 .../learn/book/your-first-game/breakout2.png  | Bin 0 -> 1855 bytes
 .../learn/book/your-first-game/breakout3.png  | Bin 0 -> 2327 bytes
 .../learn/book/your-first-game/breakout4.png  | Bin 0 -> 2624 bytes
 .../learn/book/your-first-game/breakout5.png  | Bin 0 -> 4767 bytes
 10 files changed, 692 insertions(+), 4 deletions(-)
 create mode 100644 content/learn/book/your-first-game/_index.md
 create mode 100644 content/learn/book/your-first-game/breakout1.png
 create mode 100644 content/learn/book/your-first-game/breakout2.png
 create mode 100644 content/learn/book/your-first-game/breakout3.png
 create mode 100644 content/learn/book/your-first-game/breakout4.png
 create mode 100644 content/learn/book/your-first-game/breakout5.png

diff --git a/content/learn/book/contributing/_index.md b/content/learn/book/contributing/_index.md
index 8546049d34..73af1718a9 100644
--- a/content/learn/book/contributing/_index.md
+++ b/content/learn/book/contributing/_index.md
@@ -1,6 +1,6 @@
 +++
 title = "Contributing"
-weight = 4
+weight = 5
 sort_by = "weight"
 template = "book-section.html"
 page_template = "book-section.html"
diff --git a/content/learn/book/faq/_index.md b/content/learn/book/faq/_index.md
index f89045ffd0..8f638daf3f 100644
--- a/content/learn/book/faq/_index.md
+++ b/content/learn/book/faq/_index.md
@@ -1,6 +1,6 @@
 +++
 title = "Faq"
-weight = 6
+weight = 7
 sort_by = "weight"
 template = "book-section.html"
 page_template = "book-section.html"
diff --git a/content/learn/book/next-steps/_index.md b/content/learn/book/next-steps/_index.md
index 3c0284409f..ff3098b7b1 100644
--- a/content/learn/book/next-steps/_index.md
+++ b/content/learn/book/next-steps/_index.md
@@ -1,6 +1,6 @@
 +++
 title = "Next Steps"
-weight = 3
+weight = 4
 sort_by = "weight"
 template = "book-section.html"
 page_template = "book-section.html"
diff --git a/content/learn/book/troubleshooting/_index.md b/content/learn/book/troubleshooting/_index.md
index 889c234ee8..544eac6683 100644
--- a/content/learn/book/troubleshooting/_index.md
+++ b/content/learn/book/troubleshooting/_index.md
@@ -1,6 +1,6 @@
 +++
 title = "Troubleshooting"
-weight = 5
+weight = 6
 sort_by = "weight"
 template = "book-section.html"
 page_template = "book-section.html"
diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
new file mode 100644
index 0000000000..296b035218
--- /dev/null
+++ b/content/learn/book/your-first-game/_index.md
@@ -0,0 +1,688 @@
++++
+title = "Your first game"
+weight = 3
+sort_by = "weight"
+template = "book-section.html"
+page_template = "book-section.html"
++++
+
+Okay, now that you know the basics of Bevy, let's look at an actual game. Specifically let's look at one of the examples that come with Bevy: Breakout.
+
+![screenshot1](breakout1.png)
+
+For those of you who don't know, Breakout is an arcade game developed and published by Atari in 1976. In the game a layer of bricks lines the top third of the screen and the goal is to destroy them all. A ball moves straight around the screen, bouncing off the top and two sides of the screen. When a brick is hit, the ball bounces back and the brick is destroyed. The player loses a turn when the ball touches the bottom of the screen; to prevent this from happening, the player has a horizontally movable paddle to bounce the ball upward, keeping it in play. [Source: Wikipedia](https://en.wikipedia.org/wiki/Breakout_(video_game))
+
+Here is a version of the game compiled to WebGL that you can play right away:  
+[https://mrk.sed.pl/bevy-showcase/breakout.html](https://mrk.sed.pl/bevy-showcase/breakout.html)
+
+You can take a look at the complete [source code of the game](https://github.com/bevyengine/bevy/blob/main/examples/game/breakout.rs), but I suggest to follow along this tutorial first, since it will slowly build up to the example game one step at a time.
+
+So what are the elements of the game ?
+
+ * A paddle
+ * A ball
+ * Bricks
+ * Walls
+ * A score counter
+
+Let's start with the paddle:
+
+```rs
+use bevy::{
+    prelude::*,
+    render::pass::ClearColor,
+};
+
+fn main() {
+    App::build()
+        .add_plugins(DefaultPlugins)
+        .insert_resource(ClearColor(Color::rgb(0.9, 0.9, 0.9)))
+        .add_startup_system(setup.system())
+        .add_system(paddle_movement_system.system())
+        .run();
+}
+
+struct Paddle {
+    speed: f32,
+}
+
+enum Collider {
+    Solid,
+    Scorable,
+    Paddle,
+}
+
+fn setup(
+    commands: &mut Commands,
+    mut materials: ResMut<Assets<ColorMaterial>>,
+    asset_server: Res<AssetServer>,
+) {
+    commands
+        // cameras
+        .spawn(OrthographicCameraBundle::new_2d())
+        .spawn(UiCameraBundle::default())
+        // paddle
+        .spawn(SpriteBundle {
+            material: materials.add(Color::rgb(0.5, 0.5, 1.0).into()),
+            transform: Transform::from_xyz(0.0, -215.0, 0.0),
+            sprite: Sprite::new(Vec2::new(120.0, 30.0)),
+            ..Default::default()
+        })
+        .with(Paddle { speed: 500.0 })
+        .with(Collider::Paddle);
+}
+
+fn paddle_movement_system(
+    time: Res<Time>,
+    keyboard_input: Res<Input<KeyCode>>,
+    mut query: Query<(&Paddle, &mut Transform)>,
+) {
+    for (paddle, mut transform) in query.iter_mut() {
+        let mut direction = 0.0;
+        if keyboard_input.pressed(KeyCode::Left) {
+            direction -= 1.0;
+        }
+
+        if keyboard_input.pressed(KeyCode::Right) {
+            direction += 1.0;
+        }
+
+        let translation = &mut transform.translation;
+        // move the paddle horizontally
+        translation.x += time.delta_seconds() * direction * paddle.speed;
+        // bound the paddle
+        translation.x = translation.x.min(380.0).max(-380.0);
+    }
+}
+
+```
+
+The code might be a lot to take in at first glance, but don't worry. We will take it one section at a time.
+
+Before we do that however, let's see it in action!
+
+Create a new folder and project on your hard drive using this command:
+
+```bash
+cargo new my_breakout_game
+cd my_breakout_game
+```
+Edit Cargo.toml to add a dependency on the Bevy git repo as outline in the [getting started guide](/learn/book/getting-started/).
+
+```toml
+[dependencies]
+bevy={git="https://github.com/bevyengine/bevy", rev="bc4fe9b186db3f32eef38fc4241289df480fa949"}
+```
+(We do this because for the code above Bevy 0.4 is already outdated.)
+
+Then copy and paste the large piece of code above into the main.rs file in the my_breakout_game/src folder.
+
+Finally execute this in your project folder:
+
+```bash
+cargo run
+```
+You will probably get 3 warnings. They are okay for now, we will have them fixed by the end of this tutorial.  
+
+You should be able to move the paddle with your cursor keys and it should look like this:
+
+![screenshot2](breakout2.png)
+
+Okay, so what is the code doing?
+
+```rs
+use bevy::{
+    prelude::*,
+    render::pass::ClearColor,
+};
+```
+This simply declares a couple of local name bindings to the most common Bevy types and plugins as well as a local name binding to ClearColor.
+ClearColor is a struct that contains the color we will use to clear the game with; effectively becoming the background color of our game.
+
+```rs
+fn main() {
+    App::build()
+        .add_plugins(DefaultPlugins)
+        .insert_resource(ClearColor(Color::rgb(0.9, 0.9, 0.9)))
+        .add_startup_system(setup.system())
+        .add_system(paddle_movement_system.system())
+        .run();
+}
+```
+This is the main entry point into our program. This function will be called once the program is successfully compiled and executed.
+
+[App::build()](https://github.com/bevyengine/bevy/blob/main/crates/bevy_app/src/app.rs) is a very simple function that just returns a new instance of [AppBuilder](https://docs.rs/bevy/0.4.0/bevy/app/struct.AppBuilder.html)
+
+As the other function calls suggest, the AppBuilder allows us to add plugins and (startup) systems and to insert resources.
+Finally a call to run starts the game engine with all of the configured systems, plugins and resources.
+The [getting started guide](/learn/book/getting-started/) covers these types in great detail.
+
+```rs
+add_plugins(DefaultPlugins)
+``` 
+This call simply adds all the default plugins to the app.  
+Follow this link if you are interested in a complete list of all of the default plugins: [default_plugins.rs](https://github.com/bevyengine/bevy/blob/main/crates/bevy_internal/src/default_plugins.rs)
+
+```rs
+.insert_resource(ClearColor(Color::rgb(0.9, 0.9, 0.9)))
+``` 
+Here we insert a ClearColor resource, set to a light grey. (rgb stands for the red, green and blue parts of the final color.)
+
+```rs
+.add_startup_system(setup.system())
+``` 
+Here we register our very own setup function as a startup system.
+Startup systems are only called once and before any of the normal systems are called.
+We will cover the setup function code in detail in a moment.
+
+```rs
+.add_system(paddle_movement_system.system())
+``` 
+Here we add our very own paddle_movement_system function as a system.
+Systems are called every frame.
+We will cover the paddle_movement_system function code in detail in a moment.
+
+```rs
+.run();
+``` 
+Finally we tell the Bevy game engine to start with a call to run.  
+(If you are really interested in the source code of the run function you can find it here: [app.rs](https://github.com/bevyengine/bevy/blob/main/crates/bevy_app/src/app.rs))
+
+## Let's take a look at that setup function.
+
+```rs
+struct Paddle {
+    speed: f32,
+}
+
+enum Collider {
+    Solid,
+    Scorable,
+    Paddle,
+}
+
+fn setup(
+    commands: &mut Commands,
+    mut materials: ResMut<Assets<ColorMaterial>>,
+    asset_server: Res<AssetServer>,
+) {
+    commands
+        // cameras
+        .spawn(OrthographicCameraBundle::new_2d())
+        .spawn(UiCameraBundle::default())
+        // paddle
+        .spawn(SpriteBundle {
+            material: materials.add(Color::rgb(0.5, 0.5, 1.0).into()),
+            transform: Transform::from_xyz(0.0, -215.0, 0.0),
+            sprite: Sprite::new(Vec2::new(120.0, 30.0)),
+            ..Default::default()
+        })
+        .with(Paddle { speed: 500.0 })
+        .with(Collider::Paddle);
+}
+``` 
+`struct Paddle` is a struct with one float field called speed.  
+`enum Collider` is an enumeration with three fields. We will use it to declare the type of collisions the ball can hit.
+
+Next our setup function expects three arguments:  
+ * a reference to a [Commands](https://docs.rs/bevy_ecs/0.4.0/bevy_ecs/struct.Commands.html) struct.
+ * an instance of a collection of ColorMaterials.
+ * an instance of AssetServer.
+
+The `Commands` struct can be used to spawn `Bundles` and to add `Components`.  
+Material is used to paint 2D or 3D objects on screen and `ColorMaterial` is the simplest Material as it only supports a single color as oposed to, for example, textures.  
+The AssetServer will be used in the last section of this tutorial to load the font we will use to display the game score.
+
+Inside the function (that is only run once, since it is only a startup_system) we then use the commands struct
+to spawn (or in another word, add) a couple of Bundles. Namely we spawn an orthographic and a separate UI camera.
+This is done because it is usually easier to render the UI using a different camera then the one the game objects are using.  
+This becomes especially clear when you think of combining a 3D game using a perspective camera and a UI.  
+The requirements for a UI and a 3D scene camera are so different, that is becomes easier to simply and completely separate them out.  
+Next we spawn a sprite to represent our paddle. A sprite is usually a simple little graphical 2D object, like a tree or a player character (like [2D Mario](https://i.imgur.com/ZqL6DG5h.jpg) for example).  
+```rs
+material: materials.add(Color::rgb(0.5, 0.5, 1.0).into()),
+transform: Transform::from_xyz(0.0, -215.0, 0.0),
+```
+Here we define this sprite to have a color that is light blue and to sit -215 pixels downwards from the center of the play area.
+
+```rs
+sprite: Sprite::new(Vec2::new(120.0, 30.0)),
+```
+Here we define this sprite to be 120 pixels wide and 30 pixels tall.
+
+```rs
+..Default::default()
+```
+Then we just tell Rust to give the rest of the SpriteBundle fields their appropriate [default values](https://doc.rust-lang.org/std/default/trait.Default.html).
+
+```rs
+.with(Paddle { speed: 500.0 })
+.with(Collider::Paddle);
+```
+Next we add a our Paddle as a `Component` that can be used in `Queries`. We will look at a `Query` in the next section.
+Finally we add a Component of type Collider::Paddle to this entity so the ball can later bounce off of it.
+
+
+## Let's take a look at the paddle_movement_system.
+
+```rs
+fn paddle_movement_system(
+    time: Res<Time>,
+    keyboard_input: Res<Input<KeyCode>>,
+    mut query: Query<(&Paddle, &mut Transform)>,
+) {
+    for (paddle, mut transform) in query.iter_mut() {
+        let mut direction = 0.0;
+        if keyboard_input.pressed(KeyCode::Left) {
+            direction -= 1.0;
+        }
+
+        if keyboard_input.pressed(KeyCode::Right) {
+            direction += 1.0;
+        }
+
+        let translation = &mut transform.translation;
+        // move the paddle horizontally
+        translation.x += time.delta_seconds() * direction * paddle.speed;
+        // bound the paddle
+        translation.x = translation.x.min(380.0).max(-380.0);
+    }
+}
+```
+The paddle_movement_system function expects three arguments:  
+ * an instance of the default [Time](https://docs.rs/bevy_core/0.4.0/bevy_core/struct.Time.html) resource.
+ * an instance of the default [Input](https://docs.rs/bevy_input/0.4.0/bevy_input/struct.Input.html)<KeyCode> resource under the name keyboard_input.
+ * an instance of a Query that references our Paddle and its [Transform](https://docs.rs/bevy/0.4.0/bevy/prelude/struct.Transform.html).
+
+The Time struct contains the following helpful [information](https://github.com/bevyengine/bevy/blob/main/crates/bevy_core/src/time/time.rs):
+
+```rs
+pub struct Time {
+    delta: Duration,
+    last_update: Option<Instant>,
+    delta_seconds_f64: f64,
+    delta_seconds: f32,
+    seconds_since_startup: f64,
+    startup: Instant,
+}
+```
+Inside the function, that is called every frame, we iterate over all `Components` in our scene that match the type Paddle.  
+Then we check if the left or right cursor key is pressed and we set the direction variable accordingly.  
+Finally we access the translation (a fancy word for position) field of the `Transform` instance and use it to change the horizontal (x) paddle position on the playing field.  
+As done here, it is good practice to factor in time.delta_seconds(). This makes sure that the behavior of the paddle is independent of the frame rate.
+We also have to make sure that the paddle doesn't move off of the screen. So we limit the paddle inside of 380 pixels to the right and left of the center position.
+
+## Next let's add some walls.
+
+```rs
+    let wall_material = materials.add(Color::rgb(0.8, 0.8, 0.8).into());
+    let wall_thickness = 10.0;
+    let bounds = Vec2::new(900.0, 600.0);
+
+    commands
+        // left
+        .spawn(SpriteBundle {
+            material: wall_material.clone(),
+            transform: Transform::from_xyz(-bounds.x / 2.0, 0.0, 0.0),
+            sprite: Sprite::new(Vec2::new(wall_thickness, bounds.y + wall_thickness)),
+            ..Default::default()
+        })
+        .with(Collider::Solid)
+        // right
+        .spawn(SpriteBundle {
+            material: wall_material.clone(),
+            transform: Transform::from_xyz(bounds.x / 2.0, 0.0, 0.0),
+            sprite: Sprite::new(Vec2::new(wall_thickness, bounds.y + wall_thickness)),
+            ..Default::default()
+        })
+        .with(Collider::Solid)
+        // bottom
+        .spawn(SpriteBundle {
+            material: wall_material.clone(),
+            transform: Transform::from_xyz(0.0, -bounds.y / 2.0, 0.0),
+            sprite: Sprite::new(Vec2::new(bounds.x + wall_thickness, wall_thickness)),
+            ..Default::default()
+        })
+        .with(Collider::Solid)
+        // top
+        .spawn(SpriteBundle {
+            material: wall_material,
+            transform: Transform::from_xyz(0.0, bounds.y / 2.0, 0.0),
+            sprite: Sprite::new(Vec2::new(bounds.x + wall_thickness, wall_thickness)),
+            ..Default::default()
+        })
+        .with(Collider::Solid);
+```
+Add this code to the inside of the startup function, just before it ends and run the program with `cargo run`.
+You should now see walls inside of your game just like this:
+
+![](breakout3.png)
+
+With all that we have learned so far, it should be pretty obvious what the code above does. But let's go over some interesting details.
+You might have noticed that except for the last wall, every other wall has received a clone of the wall_material.
+Why is that necessary?  
+Well two fold: It is usually good practice to give every object in a game its own material. Otherwise it can happen, that you change the color on one object and suddenly you
+have changed the color on all objects that share the same material. This is usually not what you want. Secondly, of course Rust would like to have a single material owner per SpriteBundle instance.
+So in this case we can solve both requirements with a simple call to ```wall_material.clone()```.
+
+## Next let's add the Ball. This is where the fun starts :-)
+
+First add this line to our use section at the top:
+```rs
+sprite::collide_aabb::{collide, Collision},
+```
+So it looks like this:
+```rs
+use bevy::{
+    prelude::*,
+    render::pass::ClearColor,
+    sprite::collide_aabb::{collide, Collision},
+};
+```
+This line adds a couple of cool functions that allows us to detect collsions between our ball and the other objects in our game.
+
+Next add these two lines into the middle of our main function at the top:
+```rs
+        .add_system(ball_collision_system.system())
+        .add_system(ball_movement_system.system())
+```
+so it looks like this:
+```rs
+        .add_system(paddle_movement_system.system())
+        .add_system(ball_collision_system.system())
+        .add_system(ball_movement_system.system())
+        .run();
+```
+
+Next add a struct that represents our ball right after the Paddle struct:
+```rs
+struct Ball {
+    velocity: Vec3,
+}
+```
+[Vec3](https://docs.rs/glam/0.12.0/glam/f32/struct.Vec3.html) is a struct that contains three float fields: x,y and z.  
+It is part of the [glam](https://docs.rs/glam/0.12.0/glam/) Rust crate which is a simple and fast linear algebra library for games and graphics.
+
+Add the following code to our setup function, just before we add our walls:
+```rs
+        commands.spawn(SpriteBundle {
+            material: materials.add(Color::rgb(1.0, 0.5, 0.5).into()),
+            transform: Transform::from_xyz(0.0, -50.0, 1.0),
+            sprite: Sprite::new(Vec2::new(30.0, 30.0)),
+            ..Default::default()
+        })
+        .with(Ball {
+            velocity: 400.0 * Vec3::new(0.5, -0.5, 0.0).normalize(),
+        });
+```
+This code should look very familiar by now. ;-)
+
+Add the following two functions to the end of main.rs:
+
+```rs
+fn ball_movement_system(time: Res<Time>, mut ball_query: Query<(&Ball, &mut Transform)>) {
+    let delta_seconds = f32::min(0.2, time.delta_seconds());
+    for (ball, mut transform) in ball_query.iter_mut() {
+        transform.translation += ball.velocity * delta_seconds;
+    }
+}
+fn ball_collision_system(
+    commands: &mut Commands,
+    //mut scoreboard: ResMut<Scoreboard>,
+    mut ball_query: Query<(&mut Ball, &Transform, &Sprite)>,
+    collider_query: Query<(Entity, &Collider, &Transform, &Sprite)>,
+) {
+    for (mut ball, ball_transform, sprite) in ball_query.iter_mut() {
+        let ball_size = sprite.size;
+        let velocity = &mut ball.velocity;
+        for (collider_entity, collider, transform, sprite) in collider_query.iter() {
+            let collision = collide(
+                ball_transform.translation,
+                ball_size,
+                transform.translation,
+                sprite.size,
+            );
+            if let Some(collision) = collision {
+                if let Collider::Scorable = *collider {
+                    //scoreboard.score += 1;
+                    commands.despawn(collider_entity);
+                }
+                let mut reflect_x = false;
+                let mut reflect_y = false;
+                match collision {
+                    Collision::Left => reflect_x = velocity.x > 0.0,
+                    Collision::Right => reflect_x = velocity.x < 0.0,
+                    Collision::Top => reflect_y = velocity.y < 0.0,
+                    Collision::Bottom => reflect_y = velocity.y > 0.0,
+                }
+                if reflect_x {
+                    velocity.x = -velocity.x;
+                }
+                if reflect_y {
+                    velocity.y = -velocity.y;
+                }
+                if let Collider::Solid = *collider {
+                    break;
+                }
+            }
+        }
+    }
+}
+
+```
+
+Let's run it with `cargo run`and see what happens. 
+
+It should look like this:
+
+![](breakout4.png)
+
+Okay, so what is happening inside the two functions we just added?
+
+```rs
+fn ball_movement_system(time: Res<Time>, mut ball_query: Query<(&Ball, &mut Transform)>) {
+    let delta_seconds = f32::min(0.2, time.delta_seconds());
+    for (ball, mut transform) in ball_query.iter_mut() {
+        transform.translation += ball.velocity * delta_seconds;
+    }
+}
+```
+This function is turned into a system in our setup function and is called every frame.  
+The first line makes sure that the delta time can never be more than 0.2 seconds.  
+This can happen at the beginning of a game, after some potentially slow loading resources are read from disk.
+Without this line, the ball could potentially "teleport" outside of our game.  
+
+Next we iterate over all instances of type Ball in our game using the familiar Query instance
+and we change the translation (position) using the ball's velocity combined with the delta_seconds.  
+Again we are using the delta_seconds in order to make the game independent of its framerate.
+
+
+```rs
+fn ball_collision_system(
+    commands: &mut Commands,
+    //mut scoreboard: ResMut<Scoreboard>,
+    mut ball_query: Query<(&mut Ball, &Transform, &Sprite)>,
+    collider_query: Query<(Entity, &Collider, &Transform, &Sprite)>,
+) {
+```
+The second function, `ball_collision_system` takes four arguments:
+ * A reference to the Commands instance. We can use it not only to add but also to remove entities. This will become very handy when we add the bricks in the next step.
+ * A commented out instance of our scoreboard. We will need this in the last step of this tutorial.
+ * An instance of a Query that references our Ball and its [Transform](https://docs.rs/bevy/0.4.0/bevy/prelude/struct.Transform.html) and `Sprite`.
+ * An instance of a Query that references all collidable Entities and its [Transform](https://docs.rs/bevy/0.4.0/bevy/prelude/struct.Transform.html), `Collider` and `Sprite`.
+ 
+I won't copy the complete code of the function body here again, since the code is easy enough to understand.
+Basically the code iterates over all balls (of course the game only has one, but this is the way to get it) and then it iterates over all collidable objects.
+The Query object is magic and only returns entities that contain ALL of the elements in the type list.  
+Then the code uses the handy `collide` function we imported at the top of main.rs to check for any collisions.
+If we have a collision, we check if it was with a scorable entity (a brick).  
+If that is the case, we despawn (remove) the entity from the game and increment the score by one.  
+(Since we don't have a scoreboard yet, the line to increment the score is commented out for now.)  
+Then we use some basic math to implement the reflection of the ball and finally we break the loop if we hit a wall.
+
+## Next let's add the Bricks.
+
+Okay, we are almost done! Only two easy steps remain. The first step that remains is adding the bricks. The last step will be to add the scoreboard. Let's go!
+
+Just before our setup function ends, add these lines:
+
+```rs
+    let brick_rows = 4;
+    let brick_columns = 5;
+    let brick_spacing = 20.0;
+    let brick_size = Vec2::new(150.0, 30.0);
+    let bricks_width = brick_columns as f32 * (brick_size.x + brick_spacing) - brick_spacing;
+    // center the bricks and move them up a bit
+    let bricks_offset = Vec3::new(-(bricks_width - brick_size.x) / 2.0, 100.0, 0.0);
+    let brick_material = materials.add(Color::rgb(0.5, 0.5, 1.0).into());
+    for row in 0..brick_rows {
+        let y_position = row as f32 * (brick_size.y + brick_spacing);
+        for column in 0..brick_columns {
+            let brick_position = Vec3::new(
+                column as f32 * (brick_size.x + brick_spacing),
+                y_position,
+                0.0,
+            ) + bricks_offset;
+            commands
+                .spawn(SpriteBundle {
+                    material: brick_material.clone(),
+                    sprite: Sprite::new(brick_size),
+                    transform: Transform::from_translation(brick_position),
+                    ..Default::default()
+                })
+                .with(Collider::Scorable);
+        }
+    }
+```
+Not much explanation needed I think, it is all just basic math. Do note however that we give all bricks a `Component` of type Collider::Scorable.
+In other words, we set the bricks to be colliders with the type Scorable from our Collider enum at the top of main.rs.  
+If you rememeber, we use this in the `ball_collision_system` to check if we need to increment the score board.  
+
+Execute the game with `cargo run` and it should look something like this:
+
+![](breakout5.png)
+
+## We are on the homestretch. Let's add the score and then we are done!
+
+Next add these two lines to the main function:
+```rs
+        .insert_resource(Scoreboard { score: 0 })
+        .add_system(scoreboard_system.system())
+```
+so it looks like this:
+```rs
+        .add_system(ball_movement_system.system())
+        .insert_resource(Scoreboard { score: 0 })
+        .add_system(scoreboard_system.system())
+        .run();
+```
+Next add a struct that represents our score right after the Ball struct:
+```rs
+struct Scoreboard {
+    score: usize,
+}
+```
+[usize](https://doc.rust-lang.org/std/primitive.usize.html) is a basic unsigned Rust type and represents how many bytes it takes to reference a location in memory.
+This type probably is overkill in our usecase, but it doesn't hurt either.
+
+
+Add the following lines just before the end to our setup function:
+
+```rs
+        commands.spawn(TextBundle {
+            text: Text {
+                sections: vec![
+                    TextSection {
+                        value: "Score: ".to_string(),
+                        style: TextStyle {
+                            font: asset_server.load("fonts/FiraSans-Bold.ttf"),
+                            font_size: 40.0,
+                            color: Color::rgb(0.5, 0.5, 1.0),
+                        },
+                    },
+                    TextSection {
+                        value: "".to_string(),
+                        style: TextStyle {
+                            font: asset_server.load("fonts/FiraMono-Medium.ttf"),
+                            font_size: 40.0,
+                            color: Color::rgb(1.0, 0.5, 0.5),
+                        },
+                    },
+                ],
+                ..Default::default()
+            },
+            style: Style {
+                position_type: PositionType::Absolute,
+                position: Rect {
+                    top: Val::Px(5.0),
+                    left: Val::Px(5.0),
+                    ..Default::default()
+                },
+                ..Default::default()
+            },
+            ..Default::default()
+        });
+```
+This looks different than what we had before, so let's go over it.  
+Here we are spawning a [TextBundle](https://docs.rs/bevy/0.4.0/bevy/ui/entity/struct.TextBundle.html).
+
+A TextBundle contains many useful fields:
+
+```rs
+pub struct TextBundle {
+    pub node: Node,
+    pub style: Style,
+    pub draw: Draw,
+    pub visible: Visible,
+    pub text: Text,
+    pub calculated_size: CalculatedSize,
+    pub focus_policy: FocusPolicy,
+    pub transform: Transform,
+    pub global_transform: GlobalTransform,
+}
+```
+In our case we set the text field to be two `TextSections`.
+We do this so we can change the score number independently from the label in front of it.
+And all of the `..Default::default()` calls just make sure that the rest of the respective struct fields will get sensible values.
+
+Next we add a scoreboard system function:
+
+```rs
+fn scoreboard_system(scoreboard: Res<Scoreboard>, mut query: Query<&mut Text>) {
+    for mut text in query.iter_mut() {
+        text.sections[1].value = scoreboard.score.to_string();
+    }
+}
+```
+Add this right in front of the `ball_collision_system`.  
+
+This system function asks the Bevy game engine for the resource of type Scoreboard that we added in the setup function.
+It also asks the Bevy game engine for a Query object that is able to iterate over all Text instances in our game.
+We only have one Text instance of course, but it contains our two text sections.
+Inside the function we then access the second section, the one that represents our score number, and we set it to the current score from our scoreboard instance.
+
+Next we have to uncomment the two lines inside `ball_collision_system` that were temporarily commented out.
+The two lines where: 
+```rs
+//mut scoreboard: ResMut<Scoreboard>,
+```
+and
+```rs
+//scoreboard.score += 1;
+```
+Find those two lines and remove the double slashes at the beginning.
+
+Finally we have to copy the two font files from Bevy to our project.
+The two font files are located in bevy/assets/fonts.
+You can also download them from here: [bevy/tree/main/assets/fonts](https://github.com/bevyengine/bevy/tree/main/assets/fonts)
+
+Create the folder structure assets/fonts in your my_breakout_game project folder and copy the two font files into my_breakout_game/assets/fonts.
+
+Done!
+You successfully recreated the breakout game from the Bevy examples.
+
+Let's play a round, shall we?
+
+Execute `cargo run` and have some fun.  
+You earned it!
+
diff --git a/content/learn/book/your-first-game/breakout1.png b/content/learn/book/your-first-game/breakout1.png
new file mode 100644
index 0000000000000000000000000000000000000000..182db679801dfdd72be7cc2b9c5478de4f4ea45c
GIT binary patch
literal 8453
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

literal 0
HcmV?d00001

diff --git a/content/learn/book/your-first-game/breakout2.png b/content/learn/book/your-first-game/breakout2.png
new file mode 100644
index 0000000000000000000000000000000000000000..482310221b864e31e2a1e75d17e4ce08d3e53026
GIT binary patch
literal 1855
zcmeAS@N?(olHy`uVBq!ia0y~yU@B!`VD#c(1Bz4|uiOZv7>k44ofy`glX(f`u%tWs
zIx;Y9?C1WI$O`0h7I;J!GcX91fH32|H2De!2DU4nE{-7;ac^%K`bh_hI9$y4;qqSS
zC(?3*fqT({gm4oRolajL#zM(x7Rx@Joi0p?<}q_GpP9YA;o{$4#<Q1YS~D>Gxa9ZE
zpMhbYK_EMWfWj-FyIf=$92!<IGjIriT)2pjLBZh)BLho^6+;8VsG`vz7)=GE8DZ#@
z1v7jvZ@GJ(!M(8RSN<Feqq-BXU+3g(-~3nl!1GS42P?`PzyJ7AyCzKi&^y`P3wH1N
zWqj_O*&#lQ87r9kvNqo6`TcwT<DWlE&OHCEnjf|P_>P^Cecj#DH{R^9dSI}K&tg^V
z6<eD>5~rV<2Y&Cnn$`3A_5H_x{;XfY%=fH_g$e~H)b;GqI%bdGy}MpfWhMFfXWhx!
z*Ipau<xhY7=~HTs+2+4u4~ku63rcoxn0>xB$}VZ|JZ`H88sK8QerOfwHI>PK*o(8n
VMVDL@D+5+~44$rjF6*2UngFlWyAc2Y

literal 0
HcmV?d00001

diff --git a/content/learn/book/your-first-game/breakout3.png b/content/learn/book/your-first-game/breakout3.png
new file mode 100644
index 0000000000000000000000000000000000000000..192fe53647b40908e28a1ca4d36a7ecb2d8c8884
GIT binary patch
literal 2327
zcmeAS@N?(olHy`uVBq!ia0y~yVDeyKVC>^y1B&Fh|CtS>7>k44ofy`glX(f`u%tWs
zIx;Y9?C1WI$O`0h7I;J!GcX91fH32|H2De!297nJE{-7;ac}RO&XNgdYIt~gx=S~U
zr@`yUEgxS$>D_cj`e|uTwc&-`jGijoj`52o%})H{y{X4Wt?2ysgA4iCw`jh&6o36@
z+Ga~028Mshb$6H;3REUAFgPhNGPF1_F>o}pFbFVlGAOVJF*tCjFf<4N-Td*<^eyR|
zZx*sK6j<@KKNo(nxzXh4#j97Z&Nv^N!NlNqyl%hz^y$;jyIo3W&fFN$(=Ts-FQ1XY
z?`Yn3>G${c?!IsL^r%DB`s>L%W8}ga81~iQep|LCY;`*G$-Tx<8(u}{Tz2-IU;Rs(
z;lX>ey#?Q{NdMHon^YaD;G0-dR#s;3BE;}P49KpouC|x*yst80S@>f;J-v7F{j;Aj
zFyx>8GIP<(V%O`}ulL(Ue(_~~`RC6aQ5A*<zO&Xz-Mw>XkJbd6CA^qEQzYc|Q3a3)
z8V!fha6m2+M$^L}PY-Fc&ps=dW4|dv=UCNVxzkTS?f7&OSWJtHi$DJJr$&bF{6EVN
zvewqO<<s{(`F3rm+8)=<H*@aXxzqFd^=rfV_J8K)ZNI%SYVEPS?bhpTR3<dIFSGdd
z_j`TE5`BZC7xnl5iB>r%4HW*ra(?~2zWDmT&+mTQabWYmAIUxU>waIq`|V+&(2w7>
zz6zF48RvaD%%A+{$KsEdW_%MasG=kp*}N<;*jK`^++BgOUxsh<#@oFc?@H<SX4?Dy
z=C;t?d^YX#o1f>CHcGtyTBS4n^y5?NzyH?7#KiP`{``42bMs|&3s?KUCEw@I*Z=f<
ze)nUZ3h%VdH+SsZDG97MlI`j%d^4)c+crn7edkv+&+Zy0u>Md1dST~Lw!vF-ByGEy
z!*~3ra`(}sHP>HnjM3}Yp8w|i@50K;O8aG&3<si(=bt|gtg8Rcc=kVc_uam$S*B&X
z?-o8?7|wbrg-f}Rg<(%>u!L!!+I<~hUAQk?pLJ3?v{F1Gem80MHU@^}NxQaw3q7w;
z`{RQnu$iEq%C-3W`}_O#Ca68)V6bpKfAr#$qrj%akNU@oxrkgLC-GQ+mH2x5B`S53
QfQ=ajPgg&ebxsLQ0Kq#ukpKVy

literal 0
HcmV?d00001

diff --git a/content/learn/book/your-first-game/breakout4.png b/content/learn/book/your-first-game/breakout4.png
new file mode 100644
index 0000000000000000000000000000000000000000..8de08fbdc8b38816d32d3cf6ab4383004e5417e8
GIT binary patch
literal 2624
zcmeAS@N?(olHy`uVBq!ia0y~yU~*<)VC>{z1B!GmGQR?(7>k44ofy`glX(f`u%tWs
zIx;Y9?C1WI$O`0h7I;J!GcX91fH32|H2Dgk*i}y#$B>G+x3>@WMPFrXcvyVg?{Y|j
zd+NoqW`Rl-Go1<sIj&A#8xf(dNXfvJ8q!89O*UGWC!J!kQM~NaI{E+aCED?_C(9FG
z#{B<gS$->T`)@`Dfzq-HRt66tX9kB^5=;!2`rb)K>4>!(Gc=SR&)Y8j`|s(OpJz+V
za(;0;f4`^;!vX8mz6I_4@^P})n_pz`<eEtvvM}rke#Q{BHY|B>-2ONo-RY+fb1)pZ
zogb$(+c|@8(QCsLW>ba<YHbV+TcUL*pRLzF%g%5>bN9;RKHbTC%XrR;|EOf&rohDD
zclD0J=gA+BM?LFJesKdB2!1DXqmRu~WKi(sVPwcm;$ZL)hPm>H0K`NSpzTXKN0kiy
za8XaQ_f6g&bMNFv`xxPd*}k{mep~wcY0^fC*=N&q^z)Zoe_OVDW8C`VSzD!k?~T^^
zV}C|*i-o;>{jI#?|BCeXb-sL*Wb^yO;f?#t^L^S48=7u!>yc;@He$apfB)~iKVM(3
zKVI?Sfx$2Ps$V64K7T%c{3yG8&&#5JOd)r+rRq#R*tzqUdj{Xa-4^G33LEY}_T!{D
zSv@%7BQBo&=gZ~0GQ00ST*YuF1(e|q|D1X>$<S=}*$BPq?Gwezrkh{=T4fuy`s$7M
z@m1Uf?$2hL+Sc2hn`gK8&&p3}`$LzVw*38P@AqSMvyPQWFl+3{J>8*bVHm#oHLvrF
z{d&*W3NU5m-8Pzb^1+caAC3O6E>=I@?alOoYc#WrmJlPWSZom9D1Z4$#oXk7YZ`Vd
zw>1cVcyzk<z4gEHzn>(3Zg{ZH2UMU)ZjI16mbO{)^wUoUpAG@5x7S~*)`YD-eKJFc
zsr>oD=I4*Q_5T@eyM6Sj?F)kwfzO{O*L=I#|M=qK^v92qta_NP-`$paMBqdF?Bo}#
z*Z(uC`|<GJ)4k7uDvNn)Kb_ov%w7I(G|xd^aE@eXpsaFQ1}yOG=fp?qh$U~n+4Hoh
zQlc_(`|Vz&(&B)0<%b79e|$Q<zyJOI__%w`e9ban-`td#U-#?rj~|cG+#Ib}{&;r&
zKcjQ!&mVj8`|s3e3{_uV)a?2H@AK*Ejr`nwg3bq`Gx?Mhzf?U_5OOLo2Gy)U@8&FE
zW4JV^GgB_Ma&`CJi1pVWKRnzX{+xkfc}CvM<NfmYZy2q<n)T-U{wL?Nk6-w+?DzNg
z@v_(T85jz@&Ye4VY_huly14b#k0oZE%@=WEII!|}DaYA&Ds2o5_rlDNPT;))Ya!`P
zK5M<<c{s3zbaao8nZ2mJ{?xri=P#J}x|b&~GweD0jN#YMlRsY92|I7L>;UREJwC6?
nUJBU$6TNl_Emb5Y|6!lMeV^l#58H%+tv&`%S3j3^P6<r_>z;Q5

literal 0
HcmV?d00001

diff --git a/content/learn/book/your-first-game/breakout5.png b/content/learn/book/your-first-game/breakout5.png
new file mode 100644
index 0000000000000000000000000000000000000000..f4732431b5efd304ea4e58c15f893661f214a58f
GIT binary patch
literal 4767
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
P5@2Rzb)n9{{pRlg*DLWD

literal 0
HcmV?d00001


From 314b83f4c242e1ba9d558fafb39d8add5a8b7fb5 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Sat, 20 Mar 2021 03:18:01 +0100
Subject: [PATCH 02/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: MinerSebas <66798382+MinerSebas@users.noreply.github.com>
---
 content/learn/book/your-first-game/_index.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 296b035218..6f7c923716 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -15,7 +15,7 @@ For those of you who don't know, Breakout is an arcade game developed and publis
 Here is a version of the game compiled to WebGL that you can play right away:  
 [https://mrk.sed.pl/bevy-showcase/breakout.html](https://mrk.sed.pl/bevy-showcase/breakout.html)
 
-You can take a look at the complete [source code of the game](https://github.com/bevyengine/bevy/blob/main/examples/game/breakout.rs), but I suggest to follow along this tutorial first, since it will slowly build up to the example game one step at a time.
+You can take a look at the complete [source code of the game](https://github.com/bevyengine/bevy/blob/latest/examples/game/breakout.rs), but I suggest to follow along this tutorial first, since it will slowly build up to the example game one step at a time.
 
 So what are the elements of the game ?
 
@@ -685,4 +685,3 @@ Let's play a round, shall we?
 
 Execute `cargo run` and have some fun.  
 You earned it!
-

From b691c0224e9c6b17e3fef0dd5040b80a09b0b0a1 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Sat, 20 Mar 2021 03:18:34 +0100
Subject: [PATCH 03/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: MinerSebas <66798382+MinerSebas@users.noreply.github.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 6f7c923716..ccf2cdd913 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -225,7 +225,7 @@ fn setup(
 `enum Collider` is an enumeration with three fields. We will use it to declare the type of collisions the ball can hit.
 
 Next our setup function expects three arguments:  
- * a reference to a [Commands](https://docs.rs/bevy_ecs/0.4.0/bevy_ecs/struct.Commands.html) struct.
+ * a reference to a [Commands](https://docs.rs/bevy_ecs/latest/bevy_ecs/struct.Commands.html) struct.
  * an instance of a collection of ColorMaterials.
  * an instance of AssetServer.
 

From 14e6512ed903816b48b595b1309d3fbcd6ced01f Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Sat, 20 Mar 2021 03:18:45 +0100
Subject: [PATCH 04/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: MinerSebas <66798382+MinerSebas@users.noreply.github.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index ccf2cdd913..3092fd24e3 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -186,7 +186,7 @@ We will cover the paddle_movement_system function code in detail in a moment.
 .run();
 ``` 
 Finally we tell the Bevy game engine to start with a call to run.  
-(If you are really interested in the source code of the run function you can find it here: [app.rs](https://github.com/bevyengine/bevy/blob/main/crates/bevy_app/src/app.rs))
+(If you are really interested in the source code of the run function you can find it here: [app.rs](https://github.com/bevyengine/bevy/blob/latest/crates/bevy_app/src/app.rs))
 
 ## Let's take a look at that setup function.
 

From 7e6b40b93462825440e23c1220cbea7f60aa3da5 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Sat, 20 Mar 2021 03:18:59 +0100
Subject: [PATCH 05/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: MinerSebas <66798382+MinerSebas@users.noreply.github.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 3092fd24e3..0c48c5f8b0 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -161,7 +161,7 @@ The [getting started guide](/learn/book/getting-started/) covers these types in
 add_plugins(DefaultPlugins)
 ``` 
 This call simply adds all the default plugins to the app.  
-Follow this link if you are interested in a complete list of all of the default plugins: [default_plugins.rs](https://github.com/bevyengine/bevy/blob/main/crates/bevy_internal/src/default_plugins.rs)
+Follow this link if you are interested in a complete list of all of the default plugins: [default_plugins.rs](https://github.com/bevyengine/bevy/blob/latest/crates/bevy_internal/src/default_plugins.rs)
 
 ```rs
 .insert_resource(ClearColor(Color::rgb(0.9, 0.9, 0.9)))

From ee6b0bf95ce57bce65653d2b382dd61571ce84c2 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Sat, 20 Mar 2021 03:19:14 +0100
Subject: [PATCH 06/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: MinerSebas <66798382+MinerSebas@users.noreply.github.com>
---
 content/learn/book/your-first-game/_index.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 0c48c5f8b0..f2acefaf18 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -508,8 +508,8 @@ fn ball_collision_system(
 The second function, `ball_collision_system` takes four arguments:
  * A reference to the Commands instance. We can use it not only to add but also to remove entities. This will become very handy when we add the bricks in the next step.
  * A commented out instance of our scoreboard. We will need this in the last step of this tutorial.
- * An instance of a Query that references our Ball and its [Transform](https://docs.rs/bevy/0.4.0/bevy/prelude/struct.Transform.html) and `Sprite`.
- * An instance of a Query that references all collidable Entities and its [Transform](https://docs.rs/bevy/0.4.0/bevy/prelude/struct.Transform.html), `Collider` and `Sprite`.
+ * An instance of a Query that references our Ball and its [Transform](https://docs.rs/bevy/latest/bevy/prelude/struct.Transform.html) and `Sprite`.
+ * An instance of a Query that references all collidable Entities and its [Transform](https://docs.rs/bevy/latest/bevy/prelude/struct.Transform.html), `Collider` and `Sprite`.
  
 I won't copy the complete code of the function body here again, since the code is easy enough to understand.
 Basically the code iterates over all balls (of course the game only has one, but this is the way to get it) and then it iterates over all collidable objects.

From 4237d793ca512e48b7d1ed4090ea73c6b6f0e3f3 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Sat, 20 Mar 2021 03:19:20 +0100
Subject: [PATCH 07/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: MinerSebas <66798382+MinerSebas@users.noreply.github.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index f2acefaf18..b943e25d05 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -624,7 +624,7 @@ Add the following lines just before the end to our setup function:
         });
 ```
 This looks different than what we had before, so let's go over it.  
-Here we are spawning a [TextBundle](https://docs.rs/bevy/0.4.0/bevy/ui/entity/struct.TextBundle.html).
+Here we are spawning a [TextBundle](https://docs.rs/bevy/latest/bevy/ui/entity/struct.TextBundle.html).
 
 A TextBundle contains many useful fields:
 

From 183b4772dc222e0a4164231239ad8a75d2d49fc9 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Sat, 20 Mar 2021 03:19:27 +0100
Subject: [PATCH 08/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: MinerSebas <66798382+MinerSebas@users.noreply.github.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index b943e25d05..a2899033e2 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -674,7 +674,7 @@ Find those two lines and remove the double slashes at the beginning.
 
 Finally we have to copy the two font files from Bevy to our project.
 The two font files are located in bevy/assets/fonts.
-You can also download them from here: [bevy/tree/main/assets/fonts](https://github.com/bevyengine/bevy/tree/main/assets/fonts)
+You can also download them from here: [bevy/tree/main/assets/fonts](https://github.com/bevyengine/bevy/tree/latest/assets/fonts)
 
 Create the folder structure assets/fonts in your my_breakout_game project folder and copy the two font files into my_breakout_game/assets/fonts.
 

From f1d46b0b9225bf8c5376af05c8be26bd6b4a5d52 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Sat, 20 Mar 2021 03:20:06 +0100
Subject: [PATCH 09/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: MinerSebas <66798382+MinerSebas@users.noreply.github.com>
---
 content/learn/book/your-first-game/_index.md | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index a2899033e2..ce91b60c68 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -111,9 +111,7 @@ Edit Cargo.toml to add a dependency on the Bevy git repo as outline in the [gett
 
 ```toml
 [dependencies]
-bevy={git="https://github.com/bevyengine/bevy", rev="bc4fe9b186db3f32eef38fc4241289df480fa949"}
-```
-(We do this because for the code above Bevy 0.4 is already outdated.)
+bevy = "0.5"
 
 Then copy and paste the large piece of code above into the main.rs file in the my_breakout_game/src folder.
 

From 06713e3291c9671c264a2578e4d8ec2f83aa2263 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Sat, 20 Mar 2021 03:20:55 +0100
Subject: [PATCH 10/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: MinerSebas <66798382+MinerSebas@users.noreply.github.com>
---
 content/learn/book/your-first-game/_index.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index ce91b60c68..de0d2746de 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -288,11 +288,11 @@ fn paddle_movement_system(
 }
 ```
 The paddle_movement_system function expects three arguments:  
- * an instance of the default [Time](https://docs.rs/bevy_core/0.4.0/bevy_core/struct.Time.html) resource.
- * an instance of the default [Input](https://docs.rs/bevy_input/0.4.0/bevy_input/struct.Input.html)<KeyCode> resource under the name keyboard_input.
- * an instance of a Query that references our Paddle and its [Transform](https://docs.rs/bevy/0.4.0/bevy/prelude/struct.Transform.html).
+ * an instance of the default [Time](https://docs.rs/bevy_core/latest/bevy_core/struct.Time.html) resource.
+ * an instance of the default [Input](https://docs.rs/bevy_input/latest/bevy_input/struct.Input.html)<KeyCode> resource under the name keyboard_input.
+ * an instance of a Query that references our Paddle and its [Transform](https://docs.rs/bevy/latest/bevy/prelude/struct.Transform.html).
 
-The Time struct contains the following helpful [information](https://github.com/bevyengine/bevy/blob/main/crates/bevy_core/src/time/time.rs):
+The Time struct contains the following helpful [information](https://github.com/bevyengine/bevy/blob/latest/crates/bevy_core/src/time/time.rs):
 
 ```rs
 pub struct Time {

From ec68014a138e888493b87934a6145d894d56b940 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Sat, 20 Mar 2021 03:21:25 +0100
Subject: [PATCH 11/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: MinerSebas <66798382+MinerSebas@users.noreply.github.com>
---
 content/learn/book/your-first-game/_index.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index de0d2746de..0ff9032a35 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -398,8 +398,8 @@ struct Ball {
     velocity: Vec3,
 }
 ```
-[Vec3](https://docs.rs/glam/0.12.0/glam/f32/struct.Vec3.html) is a struct that contains three float fields: x,y and z.  
-It is part of the [glam](https://docs.rs/glam/0.12.0/glam/) Rust crate which is a simple and fast linear algebra library for games and graphics.
+[Vec3](https://docs.rs/glam/latest/glam/f32/struct.Vec3.html) is a struct that contains three float fields: x,y and z.  
+It is part of the [glam](https://docs.rs/glam/latest/glam/) Rust crate which is a simple and fast linear algebra library for games and graphics.
 
 Add the following code to our setup function, just before we add our walls:
 ```rs

From 10d97317b3947818a69ed079ca25fcee886f2e27 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:23:39 +0200
Subject: [PATCH 12/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 0ff9032a35..4a93b3fc94 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -6,7 +6,7 @@ template = "book-section.html"
 page_template = "book-section.html"
 +++
 
-Okay, now that you know the basics of Bevy, let's look at an actual game. Specifically let's look at one of the examples that come with Bevy: Breakout.
+Now that you know the basics of Bevy, let's build a simple game. Specifically, let's look at one of the examples that come with Bevy: Breakout.
 
 ![screenshot1](breakout1.png)
 

From db84bc9534f3d01d6d109cafbaa4c8780ef4f019 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:24:19 +0200
Subject: [PATCH 13/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 4a93b3fc94..55f69720d9 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -107,7 +107,7 @@ Create a new folder and project on your hard drive using this command:
 cargo new my_breakout_game
 cd my_breakout_game
 ```
-Edit Cargo.toml to add a dependency on the Bevy git repo as outline in the [getting started guide](/learn/book/getting-started/).
+Edit `Cargo.toml` (found in the `my_breakout_game` folder you just created) to add a dependency on the latest version of Bevy as outlined in the [getting started guide](/learn/book/getting-started/).
 
 ```toml
 [dependencies]

From 4538cf9030a45498ec3db02c48a20162bb90df50 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:24:39 +0200
Subject: [PATCH 14/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 55f69720d9..0e49d53307 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -134,7 +134,7 @@ use bevy::{
     render::pass::ClearColor,
 };
 ```
-This simply declares a couple of local name bindings to the most common Bevy types and plugins as well as a local name binding to ClearColor.
+This brings the most common Bevy types and plugins into scope (those found in the `prelude` module), along with the `ClearColor` struct that we need.
 ClearColor is a struct that contains the color we will use to clear the game with; effectively becoming the background color of our game.
 
 ```rs

From 0f500432e3270ea184d2af1831871307ff47df10 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:25:00 +0200
Subject: [PATCH 15/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 0e49d53307..d5f3252e56 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -135,7 +135,7 @@ use bevy::{
 };
 ```
 This brings the most common Bevy types and plugins into scope (those found in the `prelude` module), along with the `ClearColor` struct that we need.
-ClearColor is a struct that contains the color we will use to clear the game with; effectively becoming the background color of our game.
+`ClearColor` is a struct that contains the color we will use to clear the game's screen; it serves as the background color of our game.
 
 ```rs
 fn main() {

From b4d67d7c79e59f49ac8a75a7690205a5a3c9d72f Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:25:20 +0200
Subject: [PATCH 16/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index d5f3252e56..0d24335875 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -151,7 +151,7 @@ This is the main entry point into our program. This function will be called once
 
 [App::build()](https://github.com/bevyengine/bevy/blob/main/crates/bevy_app/src/app.rs) is a very simple function that just returns a new instance of [AppBuilder](https://docs.rs/bevy/0.4.0/bevy/app/struct.AppBuilder.html)
 
-As the other function calls suggest, the AppBuilder allows us to add plugins and (startup) systems and to insert resources.
+As the other method calls suggest, the AppBuilder allows us to add plugins, (startup) systems and resources to our app.
 Finally a call to run starts the game engine with all of the configured systems, plugins and resources.
 The [getting started guide](/learn/book/getting-started/) covers these types in great detail.
 

From 4f6844f7f7671f4afcaba539a2fcb64757ca05bc Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:25:35 +0200
Subject: [PATCH 17/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 0d24335875..056bfaba24 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -153,7 +153,7 @@ This is the main entry point into our program. This function will be called once
 
 As the other method calls suggest, the AppBuilder allows us to add plugins, (startup) systems and resources to our app.
 Finally a call to run starts the game engine with all of the configured systems, plugins and resources.
-The [getting started guide](/learn/book/getting-started/) covers these types in great detail.
+Check the [Getting Started guide](/learn/book/getting-started/) for a refresher on the basics of these.
 
 ```rs
 add_plugins(DefaultPlugins)

From c42336adce6c210e3425cf46382296de4d4d92e1 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:25:47 +0200
Subject: [PATCH 18/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 056bfaba24..7e33dfdef1 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -159,7 +159,7 @@ Check the [Getting Started guide](/learn/book/getting-started/) for a refresher
 add_plugins(DefaultPlugins)
 ``` 
 This call simply adds all the default plugins to the app.  
-Follow this link if you are interested in a complete list of all of the default plugins: [default_plugins.rs](https://github.com/bevyengine/bevy/blob/latest/crates/bevy_internal/src/default_plugins.rs)
+You can find a complete list of all of the default plugins in the source code on GitHub in the [default_plugins.rs](https://github.com/bevyengine/bevy/blob/latest/crates/bevy_internal/src/default_plugins.rs) file.
 
 ```rs
 .insert_resource(ClearColor(Color::rgb(0.9, 0.9, 0.9)))

From c56f1d7551ede72cdd6d603be8041f33e7c61b78 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:26:13 +0200
Subject: [PATCH 19/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 7e33dfdef1..33107d7c70 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -164,7 +164,7 @@ You can find a complete list of all of the default plugins in the source code on
 ```rs
 .insert_resource(ClearColor(Color::rgb(0.9, 0.9, 0.9)))
 ``` 
-Here we insert a ClearColor resource, set to a light grey. (rgb stands for the red, green and blue parts of the final color.)
+Here we insert a ClearColor resource, set to a light grey (rgb stands for the red, green and blue parts of the final color, and the values range between 0.0 for fully black and 1.0 for fully white).
 
 ```rs
 .add_startup_system(setup.system())

From 474cec1bedc788eb5bffc514d901c395ccea556b Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:26:26 +0200
Subject: [PATCH 20/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 33107d7c70..7004084dd4 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -176,7 +176,7 @@ We will cover the setup function code in detail in a moment.
 ```rs
 .add_system(paddle_movement_system.system())
 ``` 
-Here we add our very own paddle_movement_system function as a system.
+Here we add our own `paddle_movement_system` function as a system.
 Systems are called every frame.
 We will cover the paddle_movement_system function code in detail in a moment.
 

From bcd648b2eb74a4b2260bfdd1a860945e09f14637 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:26:37 +0200
Subject: [PATCH 21/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 7004084dd4..f53a2d93b8 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -169,7 +169,7 @@ Here we insert a ClearColor resource, set to a light grey (rgb stands for the re
 ```rs
 .add_startup_system(setup.system())
 ``` 
-Here we register our very own setup function as a startup system.
+Here we register our very own `setup` function as a startup system.
 Startup systems are only called once and before any of the normal systems are called.
 We will cover the setup function code in detail in a moment.
 

From a84da0ee7d8d119b10f758d325e503e4a6fdefc8 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:26:55 +0200
Subject: [PATCH 22/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index f53a2d93b8..fd3e31ed0a 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -177,7 +177,7 @@ We will cover the setup function code in detail in a moment.
 .add_system(paddle_movement_system.system())
 ``` 
 Here we add our own `paddle_movement_system` function as a system.
-Systems are called every frame.
+Unlike startup systems, ordinary systems are automatically run once every frame.
 We will cover the paddle_movement_system function code in detail in a moment.
 
 ```rs

From cf54834c6419e4d4ea4bac248959a7505c2c0b4a Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:27:19 +0200
Subject: [PATCH 23/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index fd3e31ed0a..b58d867e60 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -178,7 +178,6 @@ We will cover the setup function code in detail in a moment.
 ``` 
 Here we add our own `paddle_movement_system` function as a system.
 Unlike startup systems, ordinary systems are automatically run once every frame.
-We will cover the paddle_movement_system function code in detail in a moment.
 
 ```rs
 .run();

From dcc6380ba7b1383ef15db3acea157f3b897b8019 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:27:30 +0200
Subject: [PATCH 24/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index b58d867e60..cda7d7bde0 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -171,7 +171,7 @@ Here we insert a ClearColor resource, set to a light grey (rgb stands for the re
 ``` 
 Here we register our very own `setup` function as a startup system.
 Startup systems are only called once and before any of the normal systems are called.
-We will cover the setup function code in detail in a moment.
+We will cover both of the systems we're adding in detail momentarily.
 
 ```rs
 .add_system(paddle_movement_system.system())

From e52f60d355bcdd5ae81ab17678b113ad49b547bf Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:28:27 +0200
Subject: [PATCH 25/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index cda7d7bde0..96017f6567 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -183,7 +183,7 @@ Unlike startup systems, ordinary systems are automatically run once every frame.
 .run();
 ``` 
 Finally we tell the Bevy game engine to start with a call to run.  
-(If you are really interested in the source code of the run function you can find it here: [app.rs](https://github.com/bevyengine/bevy/blob/latest/crates/bevy_app/src/app.rs))
+If you're curious about the details of how the `run` function works its magic, you can follow the source code trail that begins in [app.rs](https://github.com/bevyengine/bevy/blob/latest/crates/bevy_app/src/app.rs).
 
 ## Let's take a look at that setup function.
 

From df06378fc26cf0d6d1dc592640bd56759676e64a Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:28:40 +0200
Subject: [PATCH 26/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 96017f6567..2ec5b4751c 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -222,7 +222,7 @@ fn setup(
 `enum Collider` is an enumeration with three fields. We will use it to declare the type of collisions the ball can hit.
 
 Next our setup function expects three arguments:  
- * a reference to a [Commands](https://docs.rs/bevy_ecs/latest/bevy_ecs/struct.Commands.html) struct.
+ * a reference to a [`Commands`](https://docs.rs/bevy_ecs/latest/bevy_ecs/struct.Commands.html) struct.
  * an instance of a collection of ColorMaterials.
  * an instance of AssetServer.
 

From 19b8a5185dad3d05defe2cc76e2736f8d0756ed8 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:29:23 +0200
Subject: [PATCH 27/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 2ec5b4751c..1c9bf845b2 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -230,7 +230,7 @@ The `Commands` struct can be used to spawn `Bundles` and to add `Components`.
 Material is used to paint 2D or 3D objects on screen and `ColorMaterial` is the simplest Material as it only supports a single color as oposed to, for example, textures.  
 The AssetServer will be used in the last section of this tutorial to load the font we will use to display the game score.
 
-Inside the function (that is only run once, since it is only a startup_system) we then use the commands struct
+Inside the function (that is only run once, since it's a startup system) we then use the `Commands` struct
 to spawn (or in another word, add) a couple of Bundles. Namely we spawn an orthographic and a separate UI camera.
 This is done because it is usually easier to render the UI using a different camera then the one the game objects are using.  
 This becomes especially clear when you think of combining a 3D game using a perspective camera and a UI.  

From 3f0b4dd37f12354289b8dc2614d56a2a0f4be2e2 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:30:18 +0200
Subject: [PATCH 28/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 1c9bf845b2..12da24d8ce 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -359,7 +359,7 @@ With all that we have learned so far, it should be pretty obvious what the code
 You might have noticed that except for the last wall, every other wall has received a clone of the wall_material.
 Why is that necessary?  
 Well two fold: It is usually good practice to give every object in a game its own material. Otherwise it can happen, that you change the color on one object and suddenly you
-have changed the color on all objects that share the same material. This is usually not what you want. Secondly, of course Rust would like to have a single material owner per SpriteBundle instance.
+have changed the color on all objects that share the same material. This is usually not what you want. Secondly, Rust's ownership rules want a single material owner per `SpriteBundle` instance.
 So in this case we can solve both requirements with a simple call to ```wall_material.clone()```.
 
 ## Next let's add the Ball. This is where the fun starts :-)

From 9a965a7d81d83eaf8f9539b1f27273a7d6d5068a Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:30:39 +0200
Subject: [PATCH 29/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 12da24d8ce..531ad497ce 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -358,7 +358,7 @@ You should now see walls inside of your game just like this:
 With all that we have learned so far, it should be pretty obvious what the code above does. But let's go over some interesting details.
 You might have noticed that except for the last wall, every other wall has received a clone of the wall_material.
 Why is that necessary?  
-Well two fold: It is usually good practice to give every object in a game its own material. Otherwise it can happen, that you change the color on one object and suddenly you
+Well, the reason is twofold: it is usually good practice to give every object in a game its own material. Otherwise it can happen, that you change the color on one object and suddenly you
 have changed the color on all objects that share the same material. This is usually not what you want. Secondly, Rust's ownership rules want a single material owner per `SpriteBundle` instance.
 So in this case we can solve both requirements with a simple call to ```wall_material.clone()```.
 

From 576432ac89d7b354294cd30c86ca3cef1066e0cc Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:31:02 +0200
Subject: [PATCH 30/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 531ad497ce..f223912a47 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -413,6 +413,7 @@ Add the following code to our setup function, just before we add our walls:
         });
 ```
 This code should look very familiar by now. ;-)
+`normalize()` simply sets the magnitude of the direction vector to 1, allowing us to freely change its direction without worrying about how it will impact our ball's speed.
 
 Add the following two functions to the end of main.rs:
 

From 98ba7275160d48ad08b8659eab4dfc43fde277c8 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:31:13 +0200
Subject: [PATCH 31/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index f223912a47..2229cb9d7a 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -415,7 +415,7 @@ Add the following code to our setup function, just before we add our walls:
 This code should look very familiar by now. ;-)
 `normalize()` simply sets the magnitude of the direction vector to 1, allowing us to freely change its direction without worrying about how it will impact our ball's speed.
 
-Add the following two functions to the end of main.rs:
+Add the following two functions to the end of `main.rs`:
 
 ```rs
 fn ball_movement_system(time: Res<Time>, mut ball_query: Query<(&Ball, &mut Transform)>) {

From 6e566a35f9d77d5050e83c6540646c1f5da7c15d Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:31:48 +0200
Subject: [PATCH 32/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 2229cb9d7a..f1d5d32fcb 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -307,7 +307,7 @@ Inside the function, that is called every frame, we iterate over all `Components
 Then we check if the left or right cursor key is pressed and we set the direction variable accordingly.  
 Finally we access the translation (a fancy word for position) field of the `Transform` instance and use it to change the horizontal (x) paddle position on the playing field.  
 As done here, it is good practice to factor in time.delta_seconds(). This makes sure that the behavior of the paddle is independent of the frame rate.
-We also have to make sure that the paddle doesn't move off of the screen. So we limit the paddle inside of 380 pixels to the right and left of the center position.
+We also have to make sure that the paddle doesn't move off of the screen. So we limit the center of the paddle to be within 380 pixels to the right and left of the center of the screen.
 
 ## Next let's add some walls.
 

From 299eb38c263e98cfe7bfd56f9c4d17d4fd4f24ed Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:32:01 +0200
Subject: [PATCH 33/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index f1d5d32fcb..b6a8e09ef8 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -475,7 +475,7 @@ It should look like this:
 
 ![](breakout4.png)
 
-Okay, so what is happening inside the two functions we just added?
+Okay, so what's happening inside the two functions we just added?
 
 ```rs
 fn ball_movement_system(time: Res<Time>, mut ball_query: Query<(&Ball, &mut Transform)>) {

From 05e27b32a0c54e76b9f2d471cd38fbf90f32ac29 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:32:39 +0200
Subject: [PATCH 34/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index b6a8e09ef8..e94dd062e2 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -306,7 +306,7 @@ pub struct Time {
 Inside the function, that is called every frame, we iterate over all `Components` in our scene that match the type Paddle.  
 Then we check if the left or right cursor key is pressed and we set the direction variable accordingly.  
 Finally we access the translation (a fancy word for position) field of the `Transform` instance and use it to change the horizontal (x) paddle position on the playing field.  
-As done here, it is good practice to factor in time.delta_seconds(). This makes sure that the behavior of the paddle is independent of the frame rate.
+As done here, it is good practice to scale the amount of work that systems do by `time.delta_seconds()`. This makes sure that the behavior of the paddle is independent of the frame rate.
 We also have to make sure that the paddle doesn't move off of the screen. So we limit the center of the paddle to be within 380 pixels to the right and left of the center of the screen.
 
 ## Next let's add some walls.

From f3e4264798a7bc4eeaa1d3f22571e51bb69a1487 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:32:55 +0200
Subject: [PATCH 35/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index e94dd062e2..0eb3dd9f91 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -490,7 +490,7 @@ The first line makes sure that the delta time can never be more than 0.2 seconds
 This can happen at the beginning of a game, after some potentially slow loading resources are read from disk.
 Without this line, the ball could potentially "teleport" outside of our game.  
 
-Next we iterate over all instances of type Ball in our game using the familiar Query instance
+Next we iterate over all instances of type `Ball` in our game using the familiar `Query` pattern
 and we change the translation (position) using the ball's velocity combined with the delta_seconds.  
 Again we are using the delta_seconds in order to make the game independent of its framerate.
 

From 3d357639f03f46e86f98d5d3186b1745fc7e152d Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:33:44 +0200
Subject: [PATCH 36/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: MinerSebas <66798382+MinerSebas@users.noreply.github.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 0eb3dd9f91..2814ddab28 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -149,7 +149,7 @@ fn main() {
 ```
 This is the main entry point into our program. This function will be called once the program is successfully compiled and executed.
 
-[App::build()](https://github.com/bevyengine/bevy/blob/main/crates/bevy_app/src/app.rs) is a very simple function that just returns a new instance of [AppBuilder](https://docs.rs/bevy/0.4.0/bevy/app/struct.AppBuilder.html)
+[App::build()](https://docs.rs/bevy/latest/bevy/app/struct.App.html#impl) is a very simple function that just returns a new instance of [AppBuilder](https://docs.rs/bevy/latest/bevy/app/struct.AppBuilder.html)
 
 As the other method calls suggest, the AppBuilder allows us to add plugins, (startup) systems and resources to our app.
 Finally a call to run starts the game engine with all of the configured systems, plugins and resources.

From e0c822a9476a104b02a8eb35614fd22b7fa0f9f4 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:35:24 +0200
Subject: [PATCH 37/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 2814ddab28..2871b98248 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -10,7 +10,7 @@ Now that you know the basics of Bevy, let's build a simple game. Specifically, l
 
 ![screenshot1](breakout1.png)
 
-For those of you who don't know, Breakout is an arcade game developed and published by Atari in 1976. In the game a layer of bricks lines the top third of the screen and the goal is to destroy them all. A ball moves straight around the screen, bouncing off the top and two sides of the screen. When a brick is hit, the ball bounces back and the brick is destroyed. The player loses a turn when the ball touches the bottom of the screen; to prevent this from happening, the player has a horizontally movable paddle to bounce the ball upward, keeping it in play. [Source: Wikipedia](https://en.wikipedia.org/wiki/Breakout_(video_game))
+In [Breakout](https://en.wikipedia.org/wiki/Breakout_(video_game)), a layer of bricks lines the top third of the screen and the goal is to destroy them all. A ball moves straight around the screen, bouncing off the top and two sides of the screen. When a brick is hit, the ball bounces back and the brick is destroyed.  The player has a horizontally movable paddle to bounce the ball upward, keeping it in play.
 
 Here is a version of the game compiled to WebGL that you can play right away:  
 [https://mrk.sed.pl/bevy-showcase/breakout.html](https://mrk.sed.pl/bevy-showcase/breakout.html)

From 626df8bfb0531561499c0d6eb220053d6afc0db4 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:38:28 +0200
Subject: [PATCH 38/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 2871b98248..de09a53107 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -492,7 +492,7 @@ Without this line, the ball could potentially "teleport" outside of our game.
 
 Next we iterate over all instances of type `Ball` in our game using the familiar `Query` pattern
 and we change the translation (position) using the ball's velocity combined with the delta_seconds.  
-Again we are using the delta_seconds in order to make the game independent of its framerate.
+Again we are using `delta_seconds` in order to make the game independent of its framerate.
 
 
 ```rs

From 6a5546d3e8bbfccf96127adf3aeffd13d5c75509 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:38:41 +0200
Subject: [PATCH 39/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index de09a53107..838098a8b9 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -522,7 +522,7 @@ Then we use some basic math to implement the reflection of the ball and finally
 
 Okay, we are almost done! Only two easy steps remain. The first step that remains is adding the bricks. The last step will be to add the scoreboard. Let's go!
 
-Just before our setup function ends, add these lines:
+Just before our `setup` function ends, add these lines:
 
 ```rs
     let brick_rows = 4;

From 006af158b8fed316971078dcb27207dbafe70075 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:40:11 +0200
Subject: [PATCH 40/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 838098a8b9..61b72bffdd 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -553,7 +553,7 @@ Just before our `setup` function ends, add these lines:
     }
 ```
 Not much explanation needed I think, it is all just basic math. Do note however that we give all bricks a `Component` of type Collider::Scorable.
-In other words, we set the bricks to be colliders with the type Scorable from our Collider enum at the top of main.rs.  
+In other words, we set the bricks to be colliders with the type `Scorable` from our `Collider` enum at the top of main.rs.  
 If you rememeber, we use this in the `ball_collision_system` to check if we need to increment the score board.  
 
 Execute the game with `cargo run` and it should look something like this:

From 4fe917035e0b2015f3f7bc7fffcb9d900a10eeb9 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:40:21 +0200
Subject: [PATCH 41/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 61b72bffdd..65cef44fef 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -574,7 +574,7 @@ so it looks like this:
         .add_system(scoreboard_system.system())
         .run();
 ```
-Next add a struct that represents our score right after the Ball struct:
+Next add a struct that represents our score right after the `Ball` struct:
 ```rs
 struct Scoreboard {
     score: usize,

From 1d4a26851d8d12435b852c5ede3a5ee8b41b4e13 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:40:31 +0200
Subject: [PATCH 42/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 65cef44fef..97f771d4de 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -583,7 +583,6 @@ struct Scoreboard {
 [usize](https://doc.rust-lang.org/std/primitive.usize.html) is a basic unsigned Rust type and represents how many bytes it takes to reference a location in memory.
 This type probably is overkill in our usecase, but it doesn't hurt either.
 
-
 Add the following lines just before the end to our setup function:
 
 ```rs

From 0ae94353c8cf3b462d51563c5e5a7389f67cff1c Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:40:45 +0200
Subject: [PATCH 43/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 97f771d4de..b95fe8ac3d 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -621,7 +621,7 @@ Add the following lines just before the end to our setup function:
         });
 ```
 This looks different than what we had before, so let's go over it.  
-Here we are spawning a [TextBundle](https://docs.rs/bevy/latest/bevy/ui/entity/struct.TextBundle.html).
+Here we are spawning a [`TextBundle`](https://docs.rs/bevy/latest/bevy/ui/entity/struct.TextBundle.html).
 
 A TextBundle contains many useful fields:
 

From 5ac315ec1813057375050d135d43b55b4d24232d Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:40:56 +0200
Subject: [PATCH 44/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index b95fe8ac3d..ed9ba4f157 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -623,7 +623,7 @@ Add the following lines just before the end to our setup function:
 This looks different than what we had before, so let's go over it.  
 Here we are spawning a [`TextBundle`](https://docs.rs/bevy/latest/bevy/ui/entity/struct.TextBundle.html).
 
-A TextBundle contains many useful fields:
+A `TextBundle` contains many useful fields:
 
 ```rs
 pub struct TextBundle {

From 7b520830c5396a04044f4d2db38ff96a94abaede Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:41:06 +0200
Subject: [PATCH 45/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index ed9ba4f157..2e1ed52534 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -653,7 +653,7 @@ fn scoreboard_system(scoreboard: Res<Scoreboard>, mut query: Query<&mut Text>) {
 ```
 Add this right in front of the `ball_collision_system`.  
 
-This system function asks the Bevy game engine for the resource of type Scoreboard that we added in the setup function.
+This system function asks the Bevy game engine for the resource of type `Scoreboard` that we added in the setup function.
 It also asks the Bevy game engine for a Query object that is able to iterate over all Text instances in our game.
 We only have one Text instance of course, but it contains our two text sections.
 Inside the function we then access the second section, the one that represents our score number, and we set it to the current score from our scoreboard instance.

From e14e3e2c6471bb4cb7a61abb57cb5a55df7ba990 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:41:51 +0200
Subject: [PATCH 46/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 2e1ed52534..6d1aaa3742 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -655,7 +655,7 @@ Add this right in front of the `ball_collision_system`.
 
 This system function asks the Bevy game engine for the resource of type `Scoreboard` that we added in the setup function.
 It also asks the Bevy game engine for a Query object that is able to iterate over all Text instances in our game.
-We only have one Text instance of course, but it contains our two text sections.
+We only have one entity with a `Text` component of course, but it contains our two text sections.
 Inside the function we then access the second section, the one that represents our score number, and we set it to the current score from our scoreboard instance.
 
 Next we have to uncomment the two lines inside `ball_collision_system` that were temporarily commented out.

From 06aee680bec99b3c427e94749be6b48fe2323be8 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:42:15 +0200
Subject: [PATCH 47/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 6d1aaa3742..0f81e9ccb5 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -676,7 +676,7 @@ You can also download them from here: [bevy/tree/main/assets/fonts](https://gith
 Create the folder structure assets/fonts in your my_breakout_game project folder and copy the two font files into my_breakout_game/assets/fonts.
 
 Done!
-You successfully recreated the breakout game from the Bevy examples.
+You successfully recreated the Breakout game from the Bevy examples.
 
 Let's play a round, shall we?
 

From 915b34dae609ca146b544daeee2d7b4cf6abd3c8 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:44:21 +0200
Subject: [PATCH 48/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 0f81e9ccb5..4cab4579b8 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -305,7 +305,7 @@ pub struct Time {
 ```
 Inside the function, that is called every frame, we iterate over all `Components` in our scene that match the type Paddle.  
 Then we check if the left or right cursor key is pressed and we set the direction variable accordingly.  
-Finally we access the translation (a fancy word for position) field of the `Transform` instance and use it to change the horizontal (x) paddle position on the playing field.  
+Finally we access the translation (a fancy word for position) field of the `Transform` instance and use it to change the horizontal (`x`) paddle position on the playing field.  
 As done here, it is good practice to scale the amount of work that systems do by `time.delta_seconds()`. This makes sure that the behavior of the paddle is independent of the frame rate.
 We also have to make sure that the paddle doesn't move off of the screen. So we limit the center of the paddle to be within 380 pixels to the right and left of the center of the screen.
 

From 0c3ae0f6fdf3c860453f16568620058ffd295615 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:45:08 +0200
Subject: [PATCH 49/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 4cab4579b8..3e3359073f 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -17,7 +17,7 @@ Here is a version of the game compiled to WebGL that you can play right away:
 
 You can take a look at the complete [source code of the game](https://github.com/bevyengine/bevy/blob/latest/examples/game/breakout.rs), but I suggest to follow along this tutorial first, since it will slowly build up to the example game one step at a time.
 
-So what are the elements of the game ?
+So what are the elements of our game?
 
  * A paddle
  * A ball

From 0ee045b2118ab94fdb9b5977edfc6f2e8c851376 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:50:43 +0200
Subject: [PATCH 50/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 3e3359073f..d66e2da5e6 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -15,7 +15,7 @@ In [Breakout](https://en.wikipedia.org/wiki/Breakout_(video_game)), a layer of b
 Here is a version of the game compiled to WebGL that you can play right away:  
 [https://mrk.sed.pl/bevy-showcase/breakout.html](https://mrk.sed.pl/bevy-showcase/breakout.html)
 
-You can take a look at the complete [source code of the game](https://github.com/bevyengine/bevy/blob/latest/examples/game/breakout.rs), but I suggest to follow along this tutorial first, since it will slowly build up to the example game one step at a time.
+In this tutorial, we're going to build up our example game one step at a time until it reaches the finished complete [source code of the game](https://github.com/bevyengine/bevy/blob/latest/examples/game/breakout.rs).
 
 So what are the elements of our game?
 

From 9dbe419d7abbb96c09e5895092ea1802ae334651 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 00:52:59 +0200
Subject: [PATCH 51/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index d66e2da5e6..62f5e62b77 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -219,7 +219,7 @@ fn setup(
 }
 ``` 
 `struct Paddle` is a struct with one float field called speed.  
-`enum Collider` is an enumeration with three fields. We will use it to declare the type of collisions the ball can hit.
+`enum Collider` is an enumeration with three fields. We will use it to differentiate the objects that the ball can hit.
 
 Next our setup function expects three arguments:  
  * a reference to a [`Commands`](https://docs.rs/bevy_ecs/latest/bevy_ecs/struct.Commands.html) struct.

From af44d559d65547d6d63e8e0db9362a180e3de80a Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 01:01:17 +0200
Subject: [PATCH 52/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 62f5e62b77..3a7902ca19 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -223,7 +223,7 @@ fn setup(
 
 Next our setup function expects three arguments:  
  * a reference to a [`Commands`](https://docs.rs/bevy_ecs/latest/bevy_ecs/struct.Commands.html) struct.
- * an instance of a collection of ColorMaterials.
+ * a special singleton mutable reference to our `ColorMaterial`, stored within our `Asset` system
  * an instance of AssetServer.
 
 The `Commands` struct can be used to spawn `Bundles` and to add `Components`.  

From 4437f3a398212c9a13410f0d8335e4a317859468 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 01:05:28 +0200
Subject: [PATCH 53/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 3a7902ca19..0bd4c52de7 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -231,7 +231,7 @@ Material is used to paint 2D or 3D objects on screen and `ColorMaterial` is the
 The AssetServer will be used in the last section of this tutorial to load the font we will use to display the game score.
 
 Inside the function (that is only run once, since it's a startup system) we then use the `Commands` struct
-to spawn (or in another word, add) a couple of Bundles. Namely we spawn an orthographic and a separate UI camera.
+to spawn (or in another word, add) a couple of Bundles,  spawning both an orthographic (top-down) and a separate UI camera.
 This is done because it is usually easier to render the UI using a different camera then the one the game objects are using.  
 This becomes especially clear when you think of combining a 3D game using a perspective camera and a UI.  
 The requirements for a UI and a 3D scene camera are so different, that is becomes easier to simply and completely separate them out.  

From 5771407a6864ae0b5f857e4e70d07549451bb9be Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 01:07:47 +0200
Subject: [PATCH 54/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 0bd4c52de7..6be8bcb396 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -245,7 +245,8 @@ Here we define this sprite to have a color that is light blue and to sit -215 pi
 ```rs
 sprite: Sprite::new(Vec2::new(120.0, 30.0)),
 ```
-Here we define this sprite to be 120 pixels wide and 30 pixels tall.
+Here we declare that this sprite will be 120 pixels wide and 30 pixels tall.
+Usually, you would set this to the size of the sprite that you're importing, but in this case, we're procedurally generating the texture.
 
 ```rs
 ..Default::default()

From 2fff522bdbfd63580be247cadb3c2f8d0d95060c Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 01:16:07 +0200
Subject: [PATCH 55/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 6be8bcb396..6a658fea94 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -240,7 +240,7 @@ Next we spawn a sprite to represent our paddle. A sprite is usually a simple lit
 material: materials.add(Color::rgb(0.5, 0.5, 1.0).into()),
 transform: Transform::from_xyz(0.0, -215.0, 0.0),
 ```
-Here we define this sprite to have a color that is light blue and to sit -215 pixels downwards from the center of the play area.
+First, we give this sprite a light blue color, then we position it so that it sits 215 pixels below the center of our game window.
 
 ```rs
 sprite: Sprite::new(Vec2::new(120.0, 30.0)),

From 5a70b25d90219fa734abf13f83b9b327345e227d Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 01:17:18 +0200
Subject: [PATCH 56/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 6a658fea94..a97ff7de04 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -257,7 +257,7 @@ Then we just tell Rust to give the rest of the SpriteBundle fields their appropr
 .with(Paddle { speed: 500.0 })
 .with(Collider::Paddle);
 ```
-Next we add a our Paddle as a `Component` that can be used in `Queries`. We will look at a `Query` in the next section.
+Next we add a `Paddle` component that can be stored on our entities, then accessed via queries. We will look at a `Query` in the next section.
 Finally we add a Component of type Collider::Paddle to this entity so the ball can later bounce off of it.
 
 

From f32aa9c14d3a9864a3c4860ac0cb977d3a2e7f9d Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 01:17:47 +0200
Subject: [PATCH 57/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index a97ff7de04..9eca380964 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -251,7 +251,7 @@ Usually, you would set this to the size of the sprite that you're importing, but
 ```rs
 ..Default::default()
 ```
-Then we just tell Rust to give the rest of the SpriteBundle fields their appropriate [default values](https://doc.rust-lang.org/std/default/trait.Default.html).
+Then we just tell Rust to give the rest of the [`SpriteBundle`](https://docs.rs/bevy/latest/bevy/prelude/struct.SpriteBundle.html) fields their appropriate [default values](https://doc.rust-lang.org/std/default/trait.Default.html).
 
 ```rs
 .with(Paddle { speed: 500.0 })

From 9a2d9cd7b75a856a048ab6b84994c5a48763abf6 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 01:18:19 +0200
Subject: [PATCH 58/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 9eca380964..7b8f7aee09 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -258,7 +258,7 @@ Then we just tell Rust to give the rest of the [`SpriteBundle`](https://docs.rs/
 .with(Collider::Paddle);
 ```
 Next we add a `Paddle` component that can be stored on our entities, then accessed via queries. We will look at a `Query` in the next section.
-Finally we add a Component of type Collider::Paddle to this entity so the ball can later bounce off of it.
+Finally we add a `Collider` component with a `Collider::Paddle` value to this entity so the ball can later bounce off of it.
 
 
 ## Let's take a look at the paddle_movement_system.

From 1df51a036ee075b1ac2c9992c5839830e4aff035 Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 01:19:52 +0200
Subject: [PATCH 59/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 7b8f7aee09..8d112d9979 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -305,7 +305,7 @@ pub struct Time {
 }
 ```
 Inside the function, that is called every frame, we iterate over all `Components` in our scene that match the type Paddle.  
-Then we check if the left or right cursor key is pressed and we set the direction variable accordingly.  
+Then we check if the left or right arrow key is pressed and set the direction variable accordingly.  
 Finally we access the translation (a fancy word for position) field of the `Transform` instance and use it to change the horizontal (`x`) paddle position on the playing field.  
 As done here, it is good practice to scale the amount of work that systems do by `time.delta_seconds()`. This makes sure that the behavior of the paddle is independent of the frame rate.
 We also have to make sure that the paddle doesn't move off of the screen. So we limit the center of the paddle to be within 380 pixels to the right and left of the center of the screen.

From 68339c44de1cb7a7149dc4cbf34ba76918c6899b Mon Sep 17 00:00:00 2001
From: Raymond Hulha <java4life@gmail.com>
Date: Tue, 4 May 2021 01:21:03 +0200
Subject: [PATCH 60/60] Update content/learn/book/your-first-game/_index.md

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
---
 content/learn/book/your-first-game/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/learn/book/your-first-game/_index.md b/content/learn/book/your-first-game/_index.md
index 8d112d9979..624276e6b4 100644
--- a/content/learn/book/your-first-game/_index.md
+++ b/content/learn/book/your-first-game/_index.md
@@ -304,7 +304,7 @@ pub struct Time {
     startup: Instant,
 }
 ```
-Inside the function, that is called every frame, we iterate over all `Components` in our scene that match the type Paddle.  
+Inside the function, that is called every frame, we iterate over all components that match the `Paddle` type.  
 Then we check if the left or right arrow key is pressed and set the direction variable accordingly.  
 Finally we access the translation (a fancy word for position) field of the `Transform` instance and use it to change the horizontal (`x`) paddle position on the playing field.  
 As done here, it is good practice to scale the amount of work that systems do by `time.delta_seconds()`. This makes sure that the behavior of the paddle is independent of the frame rate.