From 3e224ebf2f0fbc7d71dcebb86c0d17e1d1b4484c Mon Sep 17 00:00:00 2001
From: Jake <jake.read@cba.mit.edu>
Date: Thu, 16 Nov 2023 15:50:08 -0500
Subject: [PATCH] we do a little re-org

---
 README.md | 105 +++++++++++++++++++++++++++++++++---------------------
 1 file changed, 65 insertions(+), 40 deletions(-)

diff --git a/README.md b/README.md
index 4e61986..7a86c67 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) 
-- 
GitLab