define wiring in separate file
[challenge-bot] / README.md
index 93966a70bf08ce9d3876d52a0d88e80f6b660330..9a3238ae9852a14019a32e385177e5582758b4b3 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,4 +1,32 @@
-challenge-bot
-=============
+# challenge-bot
 
-Information about the 2013 HBRC Challenge Robot.
+## prerequisites
+
+install the following software:
+
+[openSCAD](http://www.openscad.org/downloads)
+
+[fritzing](http://fritzing.org/download/)
+
+[arduino ide](http://arduino.cc/en/Main/Software)
+
+## quickstart
+
+[openSCAD tutorial](http://goo.gl/E3OQXc)
+
+[build the challenge-bot](http://goo.gl/XgB0xq)
+
+## Introduction
+
+Most introductory robots are "dead-end" robots that
+tend to strand people after they have the first
+few robot behaviors implemented -- obstacle avoid,
+wall follow, stay on table, etc.
+
+One of the primary goals of the challenge-bot is to try
+to make it expandable from simple to more complex in
+reasonable incremental steps.
+
+The base is organized around 1-inch x 1-inch grid peg-board
+which is readily available from locations such as Home
+Depot, Lowes, and lumber stores.