review and clean up some details

Author: Boshen

README.md

@@ -1,13 +1,15 @@
 # JavaScript Compiler in Rust
 
+(This is currently work in progress)
+
 JavaScript, Rust and compilers are all hard to learn,
 let's combine these three and challenge ourselves to write a JavaScript compiler in Rust.
 
 This will be the book for you if you are interested in learning Rust, compiler technologies,
 or would like to contribute to swc or Rome in the near future.
 
 The book will be a full tutorial on writing a JavaScript compiler in Rust.
-And the tutorials will go down in rabbit hole on specific topics.
+And the tutorials will go down in rabbit holes on specific topics.
 
 [Read the book](https://boshen.github.io/javascript-compiler-in-rust/docs/intro)
 [Read the tutorials](https://boshen.github.io/javascript-compiler-in-rust/blog)

blog/ecma-spec.md

@@ -5,9 +5,13 @@ title: The ECMAScript Specification
 [The ECMAScript® 2023 Language Specification](https://tc39.es/ecma262/) details everything about the JavaScript language, so anyone can implement their own JavaScript engine.
 
 For a compiler, we will study the following chapters:
-* 5. Notational Conventions
-* 11. ECMAScript Language: Source Text
-* 12. ECMAScript Language: Lexical Grammar
+
+* 5 Notational Conventions
+* 11 ECMAScript Language: Source Text
+* 12 ECMAScript Language: Lexical Grammar
 * 13 - 16 Expressions, Statments, Functions, Classes, Scripts and Modules
 * B Additional ECMAScript Features for Web Browsers
 * C The Strict Mode of ECMAScript
+
+## Cover Grammar
+https://v8.dev/blog/understanding-ecmascript-part-3

docs/ast.md

@@ -21,4 +21,5 @@ It is much nicer to work on the AST compared to the source text.
 ## Rust Optimizations
 
 ### Memory Arena
+
 Pain of dealing with lifetimes

docs/lexer.md

@@ -121,7 +121,7 @@ And [Chapter 12.6 Names and Keywords](https://tc39.es/ecma262/#sec-names-and-key
 states the identifiers are interpreted according to the Default Identifier Syntax given in Unicode Standard Annex #31.
 Specifcally,
 
-```
+```markup
 UnicodeIDStart ::
     any Unicode code point with the Unicode property “ID_Start”
 UnicodeIDContinue ::

docs/parser.md

@@ -4,6 +4,7 @@ title: Parser
 ---
 
 ## Dealing with errors
+
 Panic vs recoverable parser
 
 ## JavaScript

src/pages/index.tsx

@@ -19,7 +19,7 @@ function HomepageHeader() {
           or would like to contribute to swc or Rome in the near future.
           <br/><br/>
           The book will be a full tutorial on writing a JavaScript compiler in Rust.
-          And the tutorials will go down in rabbit hole on specific topics.
+          And the tutorials will go down in rabbit holes on specific topics.
         </p>
         <div className={styles.buttons}>
           <Link