Content editorial

Author: Ehsan M. Kermani

book/src/01_calculator/calc_intro.md

@@ -1,13 +1,8 @@
 # Calculator
 
-Our first programming language is a simple calculator supporting addition and subtraction. This is perhaps the simplest language helping us introducing the major topics from grammar to compilation and virtual machine.
+Our first programming language is a simple calculator supporting addition and subtraction. This is perhaps the *simplest language* that helps us introducing the major topics from grammar to compilation and virtual machine.
 
-If you haven't cloned the [GitHub](https://github.com/ehsanmok/create-your-own-lang-with-rust) repo already, please do and navigate to the `calculator` crate
-
-```text
-git clone https://github.com/ehsanmok/create-your-own-lang-with-rust
-cd create-your-own-lang-with-rust/calculator
-```
+If you haven't cloned the [GitHub](https://github.com/ehsanmok/create-your-own-lang-with-rust) repo already, please do and navigate to the `calculator` subdirectory.
 
 To start, we have `1 + 1;` in [examples/simple.calc](../../../calculator/src/examples/simple.calc) where you can compile with
 

book/src/01_calculator/vm.md

@@ -32,14 +32,14 @@ In a unary expression like `"1"`, we encode `Node::Int(1)` as the opcode `[1, 0,
 
 ### Bytecode
 
-So we define
+We define
 
 ```rust,ignore
 {{#include ../../../calculator/src/compiler/vm/bytecode.rs:bytecode}}
 ```
 <span class="filename">Filename: calculator/src/compiler/vm/bytecode.rs</span>
 
-and as an example, `"1 + 2"` AST to Bytecode pictorially is
+and as an example, here is `"1 + 2"` AST to Bytecode conversion pictorially
 
 <p align="center">
 </br>

book/src/intro.md

@@ -1,16 +1,20 @@
-> Materials in this book are distributed under the terms of [Creative Commons BY-NC-SA 4.0](../../LICENSE)
+> Materials in this book are distributed under the terms of [Creative Commons BY-NC-SA 4.0](https://github.com/ehsanmok/create-your-own-lang-with-rust/blob/master/LICENSE)
 > <p align="center">
 >  <a href><img alt="license" src="./img/by-nc-sa.png" width="250" height="100"> </a>
 > </p>
 
-This book assumes some basic knowledge of Rust language. Please take a look  at the official [Rust book](https://doc.rust-lang.org/book/).
+This book assumes some basic knowledge of Rust language. Please take a look at the official [Rust book](https://doc.rust-lang.org/book/).
 
-The accompanying codes and materials for this book are available in [GitHub](https://github.com/ehsanmok/create-your-own-lang-with-rust). To follow along, clone the repository
+The accompanying codes and materials for this book are available in [GitHub](https://github.com/ehsanmok/create-your-own-lang-with-rust). To follow along, make sure you have
 
-```text
-git clone https://github.com/ehsanmok/create-your-own-lang-with-rust
-cd create-your-own-lang-with-rust
-```
+* [Rust installed](https://www.rust-lang.org/tools/install)
+* Cloned the repository
+
+ ```text
+ git clone https://github.com/ehsanmok/create-your-own-lang-with-rust
+ cd create-your-own-lang-with-rust
+ ```
+* LLVM v10.0 installed ([Debina/Ubuntu](https://apt.llvm.org/) or [macOS](https://formulae.brew.sh/formula/llvm)) to run and test locally `cargo test --tests`
 
 ## Motivations and Goals
 
@@ -23,7 +27,7 @@ The following are my guidelines
 
 > "If you can’t explain something in simple terms, you don’t understand it" <sup>[2](https://skeptics.stackexchange.com/questions/8742/did-einstein-say-if-you-cant-explain-it-simply-you-dont-understand-it-well-en)</sup>
 
-<span style="font-family:Trebuchet MS"> Pedagogically, one of the most effect methods of teaching is co-creating interactively. Introducing the core aspects around the *simplest example* (here, our calculator language) helps a lot to build knowledge and confidence. For that, we will use mature technologies instead of spending tone of time on partially reinventing-the-wheel and bore the reader.</span>
+<span style="font-family:Trebuchet MS"> Pedagogically, one of the most effective methods of teaching is co-creating interactively. Introducing the core aspects around the *simplest example* (here, our calculator language) helps a lot to build knowledge and confidence. For that, we will use mature technologies instead of spending tone of time on partially reinventing-the-wheel and bore the reader.</span>
 
 Here is the outline of the contents