Cleaning up

reorganization plan.md

@@ -497,69 +497,69 @@ All primitive types implement Stackable.
   - Related operators
 
 **All Operators** (alphabetical):
-- != (not equal)
+- `!=` (not equal)
-- % (modulo)
+- `%` (modulo)
-- & (this is bitand)
+- `&` (this is bitand)
-- * (multiply)
+- `*` (multiply)
-- + (add)
+- `+` (add)
-- - (subtract)
+- `-` (subtract)
-- / (divide)
+- `/` (divide)
-- < (less than)
+- `<` (less than)
-- <= (less or equal)
+- `<=` (less or equal)
-- == (equal)
+- `==` (equal)
-- > (greater than)
+- `>` (greater than)
-- >= (greater or equal)
+- `>=` (greater or equal)
-- ^ (exponentiate)
+- `^` (exponentiate)
-- | (this is bitor)
+- `|` (this is bitor)
-- and (logical and)
+- `and` (logical and)
-- at (array access)
+- `at` (array access)
-- bitand (bitwise and)
+- `bitand` (bitwise and)
-- bitnot (bitwise not)
+- `bitnot` (bitwise not)
-- bitor (bitwise or)
+- `bitor` (bitwise or)
-- bitxor (bitwise xor)
+- `bitxor` (bitwise xor)
-- break (exit loop)
+- `break` (exit loop)
-- concat (concatenate)
+- `concat` (concatenate)
-- continue (skip iteration)
+- `continue` (skip iteration)
-- depth (stack depth)
+- `depth` (stack depth)
-- drop (remove top)
+- `drop` (remove top)
-- dup (duplicate top)
+- `dup` (duplicate top)
-- each (iterate)
+- `each` (iterate)
-- enum (define enum)
+- `enum` (define enum)
-- eval (execute code)
+- `eval` (execute code)
-- filter (filter array)
+- `filter` (filter array)
-- fn (define function)
+- `fn` (define function)
-- for (for loop)
+- `for` (for loop)
-- get (field access)
+- `get` (field access)
-- if (conditional)
+- `if` (conditional)
-- impl (implement trait)
+- `impl` (implement trait)
-- inher (trait inheritance)
+- `inher` (trait inheritance)
-- lambda (create lambda)
+- `lambda` (create lambda)
-- length (container length)
+- `length` (container length)
-- ln (natural log)
+- `ln` (natural log)
-- log (log base 10)
+- `log` (log base 10)
-- logb (log with base)
+- `logb` (log with base)
-- map (transform array)
+- `map` (transform array)
-- match (pattern match)
+- `match` (pattern match)
-- not (logical not)
+- `not` (logical not)
-- or (logical or)
+- `or` (logical or)
-- over (copy second)
+- `over` (copy second)
-- pick (copy nth)
+- `pick` (copy nth)
-- reduce (fold array)
+- `reduce` (fold array)
-- reverse (reverse array)
+- `reverse` (reverse array)
-- roll (rotate n items)
+- `roll` (rotate n items)
-- rot (rotate three)
+- `rot` (rotate three)
-- set (field assignment)
+- `set` (field assignment)
-- shl (shift left)
+- `shl` (shift left)
-- shr (shift right)
+- `shr` (shift right)
-- slice (extract slice)
+- `slice` (extract slice)
-- struct (define struct)
+- `struct` (define struct)
-- substr (substring)
+- `substr` (substring)
-- swap (swap two)
+- `swap` (swap two)
-- trait (define trait)
+- `trait` (define trait)
-- transpose (transpose array)
+- `transpose` (transpose array)
-- union (define union)
+- `union` (define union)
-- while (while loop)
+- `while` (while loop)
-- window (sliding window)
+- `window` (sliding window)
 
 **Format Example**:
 ```
@@ -629,19 +629,19 @@ for their complete specifications.
 ---
 
 ### Appendix G: Examples & Tutorials
-**Content Source**: Appendix D from v0.7 + human-verified code blocks scattered throughout
+**Content Source**: Appendix D from v0.7 ~~+ human-verified code blocks scattered throughout~~
 **Organization**:
 - G.1 Tutorial: First Steps
 - G.2 Tutorial: Working with Traits
 - G.3 Tutorial: Generic Programming
 - G.4 Complete Examples (from current Appendix D)
-- G.5 Verified Code Examples (human-reviewed blocks from throughout v0.7)
+- ~~G.5 Verified Code Examples (human-reviewed blocks from throughout v0.7)~~ These were removed between v0.7 and v0.7.2.
 
 **Changes**:
 - Move all "Example - Actual Language Definitions" and "Example - Using Actual Definitions" blocks here
 - Organize by topic/difficulty
 - Add tutorial-style explanations
-- Keep human verification notes with blocks
+- ~~Keep human verification notes with blocks~~
 
 **New Tutorial Sections**:
 
@@ -671,10 +671,11 @@ for their complete specifications.
 - D.7 Array Processing → G.4.7
 - D.8 Identifier Literals in Practice → G.4.8
 
-**G.5 Verified Code Examples**:
+~~**G.5 Verified Code Examples**:~~
-- All human-verified code blocks from v0.7
+- ~~All human-verified code blocks from v0.7~~
-- Organized by topic
+- ~~Organized by topic~~
-- Include verification notes
+- ~~Include verification notes~~
+These were removed between v0.7 and v0.7.2.
 
 ---
 
@@ -727,7 +728,7 @@ for their complete specifications.
 | New | Appendix A | Standard Library Reference |
 | New | Appendix C | Operator Reference |
 | New | Appendix G.1-G.3 | Tutorials |
-| New | Appendix G.5 | Verified Examples |
+| ~~New~~ | ~~Appendix G.5~~ | ~~Verified Examples~~ These were removed between v0.7 and v0.7.2. |
 
 ---
 
@@ -761,15 +762,17 @@ To maintain minimal duplication, use consistent cross-references:
 
 ### Code Block Annotations
 
-Preserve all human verification notes:
+~~Preserve all human verification notes:~~
 ```
 > **For AI Reviewers @ 0.5:** The following block has been human verified...
 ```
+These were removed between v0.7 and v0.7.2.
 
 Remove "Example - Actual Language Definitions" labels - replace with clearer context:
 - "Defining a trait:" (instead of "Example - Actual Language Definitions:")
 - "Using the operator:" (instead of "Example - Using Actual Definitions:")
 - "Complete implementation:" (for full examples)
+Where these weren't fixed between v0.6 and v0.7. Be careful not to confuse examples (including examples using *language definitions*/*appendix reference segments*; and examples that use code that isn't actually part of any build-in or standard library code) and the actual language definitions that are in the appendix sections A, B, and C.
 
 ### Section Headers
 
@@ -826,7 +829,7 @@ For the AI agent implementing v0.8:
 - [ ] Add cross-references throughout
 - [ ] Remove duplicate content (trait definitions from main sections)
 - [ ] Update all internal section references
-- [ ] Preserve all human-verified code blocks with notes
+- [ ] ~~Preserve all human-verified code blocks with notes~~ These were removed between v0.7 and v0.7.2.
 - [ ] Remove "Example - Actual Language Definitions" labels
 - [ ] Add reading guide to Section 1
 - [ ] Verify all cross-references are valid
@@ -852,13 +855,13 @@ The reorganization is successful if:
 
 ## Notes for Implementation Agent
 
-1. **Preserve all human-verified blocks** - These have "For AI Reviewers @ 0.5" notes
+1. ~~**Preserve all human-verified blocks** - These have "For AI Reviewers @ 0.5" notes~~ These were removed between v0.7 and v0.7.2.
 2. **Don't paraphrase trait definitions** - Copy them exactly to Appendix B
 3. **Keep code examples** - Don't summarize, show actual code
 4. **Maintain postfix consistency** - All examples should be valid postfix notation
 5. **Cross-reference liberally** - Better to over-reference than under-reference
 6. **Check operator list completeness** - Appendix C must have ALL operators
 7. **Alphabetize carefully** - Appendices A, B, C are reference material
-8. **Preserve TODO comments** - Keep the one remaining human TODO
+8. ~~**Preserve TODO comments** - Keep the one remaining human TODO~~ This was removed between v0.7 and v0.7.2.
 9. **Grammar simplification** - Don't remove grammar, just avoid duplication
 10. **Tutorial quality** - Appendix G.1-G.3 should be beginner-friendly