diff --git a/README.md b/README.md
index 4e6198699f99d94158fdb36f14fc53e4246fee04..7a86c67f3c8a37f821029d222c985785dd6c4c96 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,67 @@
 # Machine Week 2023 
 
-## MechE (that we can build with the kit)
+```
+everything's connected but nothing's working ! 
+```
 
-- framing gussets
-- one belt axis design
-- lead screw example
-- one rotary example 
+# Your (Group) Task 
+
+Each section will design and build a "machine" - this means anything that includes **mechanism, actuation, automation and application**, that just means:
+
+### **Mechanism:** mechanical degrees-of-freedom (DOF)
+
+Stuff shuld move around. 
+
+### **Actuation:** computer-controllable motion of the above DOFs
+
+The motion should be computer controlled. 
+
+### **Automation / Application** software-coordinated computer-control of the above, and i.e. sequences therein 
+
+The motion should result in some desired outcome... maybe make something, draw something, change something, assemble something, sort something, cast a spell, etc. 
+
+> We can also think more broadly about "tools" - what does it mean to build a computer-controlled system that acts like a tool, interacting with the world but being mediated by some designer's intent... it's a [foamcore world](https://web.mit.edu/imoyer/www/portfolio/foamcore/index.html). 
+
+--- 
+
+# Examples / Ideas 
+
+The machines you design and build **don't need to be complicated** - try to de-risk ideas early, and do stuff that "works right away" rather than complex projects that require hundreds of details to come together all at once in order to work. This can be fun; have fun. 
+
+### [Label Maker](https://www.youtube.com/watch?v=Y_rrbo6_42U&t=73s)
+### [Wire Cutter](https://youtu.be/7E6iHRjvH_k?t=20)
+### [Music Machines](https://youtu.be/dhKYxDzyXqI?t=5)
+### [String / Floating Machines](https://youtu.be/dZLtPFJEQi0?t=104)
+### [Architecture-Scale / Space Transforming](https://fab.cba.mit.edu/classes/865.21/people/gilsunshine/systems.html)
+### [Claw Machine](https://youtu.be/zR3BLM_TAmg?t=117)
+### [Robot Chainsaw Machine](https://youtu.be/ix68oRfI5Gw?t=1160) 
+### [Robot Basketball Hoop](https://youtu.be/myO8fxhDRW0?t=598) 
+
+# Examples from this Kit 
+
+## MechE Components
+
+### Framing Gussets 
+
+! IMG of each, link to cad. Maybe a set of them "deployed" in a chassis. 
+
+### Belt Axis 
+
+! IMG of it, link to cad and BOM, or a readme-each? 
+
+### Leadscrew Axis 
+
+! IMG of it, link to cad. 
+
+### A Rotary Axis 
+
+Using [the design pattern explained here](https://ekswhyzee.com/2019/04/09/gt2-belt-rotary-cad.html). 
+
+! IMG of it, link to cad. 
+
+### The Blot
+
+--- 
 
 ## MechE (examples)
 
@@ -27,15 +83,13 @@
 - low-fet 
 - BNO085 
 
-## Stable Codes
+## Making new Things 
 
-- simple motion controller 
-  - fixed point / stability update 
-  - ... the synchronizer, goddamn 
-- blot svg-parse thing ffs 
 - how-to-add a new thing 
 
-## Kit 
+--- 
+
+# The Kit 
 
 | Part | QTY | Ordered ? | Arrived ? | Kitted ? |
 | --- | --- | --- | --- | --- |
@@ -77,35 +131,6 @@
 
 --- 
 
-# The Task 
-
-Each section will design and build a "machine" - this means anything that includes **mechanism, actuation, automation and application**, so:
-
-### **Mechanism:** mechanical degrees-of-freedom (DOF)
-
-### **Actuation:** computer-controllable motion of the above DOFs
-
-### **Automation:** software-coordinated computer-control of the above, and i.e. sequences therein 
-
-### **Application:** pipelines from desired (designed) outcomes (shapes generated, patterns drawn, parts picked-and-placed etc), to actual outcomes (real stuff!)
-
---- 
-
-# Examples / Ideas 
-
-The machines you design and build **don't need to be complicated** - try to de-risk ideas early, and do stuff that "works right away" rather than complex projects that require hundreds of details to come together all at once in order to work. This can be fun; have fun. 
-
-### [Label Maker](https://www.youtube.com/watch?v=Y_rrbo6_42U&t=73s)
-### [Wire Cutter](https://youtu.be/7E6iHRjvH_k?t=20)
-### [Music Machines](https://youtu.be/dhKYxDzyXqI?t=5)
-### [String / Floating Machines](https://youtu.be/dZLtPFJEQi0?t=104)
-### [Architecture-Scale / Space Transforming](https://fab.cba.mit.edu/classes/865.21/people/gilsunshine/systems.html)
-### [Claw Machine](https://youtu.be/zR3BLM_TAmg?t=117)
-### [Robot Chainsaw Machine](https://youtu.be/ix68oRfI5Gw?t=1160) 
-### [Robot Basketball Hoop](https://youtu.be/myO8fxhDRW0?t=598) 
-
----
-
 # Useful Design Notes
 
 [How to Make Something that Makes Almost Anything](https://fab.cba.mit.edu/classes/865.21/index.html)