cleanup, docs

README.md

@@ -4,14 +4,15 @@ A custom Blockly app needs to define:
 - blocks
   - inputs
   - fields
+  - validators
   - generators
+  - extensions
   - mixins
   - mutators
-  - extensions
-  - validators
 - toolboxes
   - categories
   - buttons
+  - labels
 - workspaces
   - starting blocks
   - settings

lifecycle.md

@@ -0,0 +1,36 @@
+# Lifecycle of a Blockly App
+
+## Using Blockly Tool
+
+- generate new app
+- configure
+- run the dev server
+- create a workspace, a toolbox, and some blocks
+- run the exporter
+- take your exported blockly files to where you want them
+
+## Blockly (De)Serialization
+
+When `Blockly.serialization.workspaces.load` is called, serializers are called in order with state to deserialize.
+
+### Deserialization Order
+
+1. **Variables**
+2. **Procedures**
+3. **Blocks** Top-level blocks are deserialized in an arbitrary order.
+  1. **Type**
+    - constructs the block, calls its init method, mixes in extensions
+  2. **Attributes**
+    - including global block properties, like: x, y, collapsed, disabled, and data
+  3. **Extra state**
+    - see the Extensions and Mutators
+  4. **Parent Connection**
+  5. **Icons**
+    - arbitrary order
+  6. **Fields**
+    - arbitrary order
+  7. **Input Blocks**
+    - both value and statement inputs, arbitrary order
+    - recursive
+  8. **Next Blocks**
+    - recursive

scratch.md

@@ -1,4 +1,4 @@
-### Acton Specification
+### Action Specification
 
 ```js
 const actionSpecification = {