adding note about IGNORING previous first edition text in files while the titles are in progress

Author: getify

es-next-beyond/ch1.md

@@ -21,6 +21,10 @@
 
 ----
 
+| NOTE: |
+| :--- |
+| Everything below here is previous text from 1st edition, and is only here for reference while 2nd edition work is underway. **Please ignore this stuff.** |
+
 Before you dive into this book, you should have a solid working proficiency over JavaScript up to the most recent standard (at the time of this writing), which is commonly called *ES5* (technically ES 5.1). Here, we plan to talk squarely about the upcoming *ES6*, as well as cast our vision beyond to understand how JS will evolve moving forward.
 
 If you are still looking for confidence with JavaScript, I highly recommend you read the other titles in this series first:

es-next-beyond/ch2.md

@@ -21,6 +21,10 @@
 
 ----
 
+| NOTE: |
+| :--- |
+| Everything below here is previous text from 1st edition, and is only here for reference while 2nd edition work is underway. **Please ignore this stuff.** |
+
 If you've been writing JS for any length of time, odds are the syntax is pretty familiar to you. There are certainly many quirks, but overall it's a fairly reasonable and straightforward syntax that draws many similarities from other languages.
 
 However, ES6 adds quite a few new syntactic forms that take some getting used to. In this chapter, we'll tour through them to find out what's in store.

es-next-beyond/ch3.md

@@ -21,6 +21,10 @@
 
 ----
 
+| NOTE: |
+| :--- |
+| Everything below here is previous text from 1st edition, and is only here for reference while 2nd edition work is underway. **Please ignore this stuff.** |
+
 It's one thing to write JS code, but it's another to properly organize it. Utilizing common patterns for organization and reuse goes a long way to improving the readability and understandability of your code. Remember: code is at least as much about communicating to other developers as it is about feeding the computer instructions.
 
 ES6 has several important features that help significantly improve these patterns, including: iterators, generators, modules, and classes.

es-next-beyond/ch4.md

@@ -21,6 +21,10 @@
 
 ----
 
+| NOTE: |
+| :--- |
+| Everything below here is previous text from 1st edition, and is only here for reference while 2nd edition work is underway. **Please ignore this stuff.** |
+
 It's no secret if you've written any significant amount of JavaScript that asynchronous programming is a required skill. The primary mechanism for managing asynchrony has been the function callback.
 
 However, ES6 adds a new feature that helps address significant shortcomings in the callbacks-only approach to async: *Promises*. In addition, we can revisit generators (from the previous chapter) and see a pattern for combining the two that's a major step forward in async flow control programming in JavaScript.

es-next-beyond/ch5.md

@@ -21,6 +21,10 @@
 
 ----
 
+| NOTE: |
+| :--- |
+| Everything below here is previous text from 1st edition, and is only here for reference while 2nd edition work is underway. **Please ignore this stuff.** |
+
 Structured collection and access to data is a critical component of just about any JS program. From the beginning of the language up to this point, the array and the object have been our primary mechanism for creating data structures. Of course, many higher-level data structures have been built on top of these, as user-land libraries.
 
 As of ES6, some of the most useful (and performance-optimizing!) data structure abstractions have been added as native components of the language.

es-next-beyond/ch6.md

@@ -21,6 +21,10 @@
 
 ----
 
+| NOTE: |
+| :--- |
+| Everything below here is previous text from 1st edition, and is only here for reference while 2nd edition work is underway. **Please ignore this stuff.** |
+
 From conversions of values to mathematic calculations, ES6 adds many static properties and methods to various built-in natives and objects to help with common tasks. In addition, instances of some of the natives have new capabilities via various new prototype methods.
 
 **Note:** Most of these features can be faithfully polyfilled. We will not dive into such details here, but check out "ES6 Shim" (https://github.com/paulmillr/es6-shim/) for standards-compliant shims/polyfills.

es-next-beyond/ch7.md

@@ -21,6 +21,10 @@
 
 ----
 
+| NOTE: |
+| :--- |
+| Everything below here is previous text from 1st edition, and is only here for reference while 2nd edition work is underway. **Please ignore this stuff.** |
+
 Meta programming is programming where the operation targets the behavior of the program itself. In other words, it's programming the programming of your program. Yeah, a mouthful, huh?
 
 For example, if you probe the relationship between one object `a` and another `b` -- are they `[[Prototype]]` linked? -- using `a.isPrototypeOf(b)`, this is commonly referred to as introspection, a form of meta programming. Macros (which don't exist in JS, yet) --  where the code modifies itself at compile time -- are another obvious example of meta programming. Enumerating the keys of an object with a `for..in` loop, or checking if an object is an *instance of* a "class constructor", are other common meta programming tasks.

es-next-beyond/ch8.md

@@ -21,6 +21,10 @@
 
 ----
 
+| NOTE: |
+| :--- |
+| Everything below here is previous text from 1st edition, and is only here for reference while 2nd edition work is underway. **Please ignore this stuff.** |
+
 At the time of this writing, the final draft of ES6 (*ECMAScript 2015*) is shortly headed toward its final official vote of approval by ECMA. But even as ES6 is being finalized, the TC39 committee is already hard at work on features for ES7/2016 and beyond.
 
 As we discussed in Chapter 1, it's expected that the cadence of progress for JS is going to accelerate from updating once every several years to having an official version update once per year (hence the year-based naming). That alone is going to radically change how JS developers learn about and keep up with the language.

es-next-beyond/toc.md

@@ -1,4 +1,4 @@
-# You Don't Know JS Yet: ES.Next & Beyond
+# You Don't Know JS Yet: ES.Next & Beyond - 2nd Edition
 
 | NOTE: |
 | :--- |
@@ -9,54 +9,54 @@
 * Foreword
 * Preface
 * Chapter 1: ES? Now & Future
-	* Versioning
-	* Transpiling
+    * Versioning
+    * Transpiling
 * Chapter 2: Syntax
-	* Block-Scoped Declarations
-	* Spread / Rest
-	* Default Parameter Values
-	* Destructuring
-	* Object Literal Extensions
-	* Template Literals
-	* Arrow Functions
-	* `for..of` Loops
-	* Regular Expression Extensions
-	* Number Literal Extensions
-	* Unicode
-	* Symbols
+    * Block-Scoped Declarations
+    * Spread / Rest
+    * Default Parameter Values
+    * Destructuring
+    * Object Literal Extensions
+    * Template Literals
+    * Arrow Functions
+    * `for..of` Loops
+    * Regular Expression Extensions
+    * Number Literal Extensions
+    * Unicode
+    * Symbols
 * Chapter 3: Organization
-	* Iterators
-	* Generators
-	* Modules
-	* Classes
+    * Iterators
+    * Generators
+    * Modules
+    * Classes
 * Chapter 4: Async Flow Control
-	* Promises
-	* Generators + Promises
+    * Promises
+    * Generators + Promises
 * Chapter 5: Collections
-	* TypedArrays
-	* Maps
-	* WeakMaps
-	* Sets
-	* WeakSets
+    * TypedArrays
+    * Maps
+    * WeakMaps
+    * Sets
+    * WeakSets
 * Chapter 6: API Additions
-	* `Array`
-	* `Object`
-	* `Math`
-	* `Number`
-	* `String`
+    * `Array`
+    * `Object`
+    * `Math`
+    * `Number`
+    * `String`
 * Chapter 7: Meta Programming
-	* Function Names
-	* Meta Properties
-	* Well Known Symbols
-	* Proxies
-	* `Reflect` API
-	* Feature Testing
-	* Tail Call Optimization (TCO)
+    * Function Names
+    * Meta Properties
+    * Well Known Symbols
+    * Proxies
+    * `Reflect` API
+    * Feature Testing
+    * Tail Call Optimization (TCO)
 * Chapter 8: Beyond ES6
-	* `async function`s
-	* `Object.observe(..)`
-	* Exponentiation Operator
-	* Object Properties and `...`
-	* `Array#includes(..)`
-	* SIMD
+    * `async function`s
+    * `Object.observe(..)`
+    * Exponentiation Operator
+    * Object Properties and `...`
+    * `Array#includes(..)`
+    * SIMD
 * Appendix A: TODO

getting-started/toc.md

@@ -27,10 +27,10 @@
     * Iteration
     * Asking Why
 * Chapter 4: The Rest (of the Series)
-    * In Order
     * Pillar 1: Scope and Closure
     * Pillar 2: Prototypes
     * Pillar 3: Types and Coercion
+    * In Order
     * With The Grain
 * Appendix A: Practice, Practice, Practice!
     * TODO