Mostly finish docs and driver pages

WasabiFan · WasabiFan · commit 9d1b6cf9179b · 2016-09-29T10:58:26.000-07:00
Fixes ev3dev#242
diff --git a/docs/driver-access.md b/docs/driver-access.md
@@ -6,6 +6,21 @@ subtitle: Controlling ev3dev devices through the low-level drivers
 Ev3dev exposes motors, sensors and other EV3-related devices through a set of
 drivers that are built into the platform. If you want to access those drivers
 directly instead of using [a pre-built library](/docs/libraries), you'll need
-to read from and write to the sysfs properties that ev3dev exposes.
+to read from and write to the sysfs properties that ev3dev exposes. Here are
+some resources to get you started.
 
-**TODO**
+- **[Input and output ports](/docs/ports)**: The input and output ports on the
+  EV3 and other ev3dev-supported hardware.
+
+- **[Supported Sensors and Other Input Devices](/docs/sensors)**: The drivers and
+  interfaces that operate sensors and other input devices.
+
+- **[Supported Motors and Other Output Devices](/docs/motors)**: The drivers and
+  interfaces that operate motors and other output devices. The most common
+  motor interface on ev3dev is the [`tacho-motor` class](/docs/drivers/tacho-motor-class/),
+  so it is important to read through the documentation for it when writing motor
+  code. You can also read through our [tacho motor tutorial](/docs/tutorials/tacho-motors)
+  to learn how to use the motor interface.
+
+- **[ev3dev kernel drivers](/docs/drivers)**: An index of all the special
+  hardware drivers that ev3dev ships with.
diff --git a/docs/index.html b/docs/index.html
@@ -28,7 +28,7 @@
 <h2>System setup</h2>
 <p>
     If you're looking to set up a new installation of ev3dev, check out
-    our <a href="getting-started">getting started</a> guide.
+    our <a href="/docs/getting-started">Getting Started</a> guide.
 </p>
 
 <h2>Tutorials</h2>
@@ -40,30 +40,16 @@ <h2>Tutorials</h2>
 
 <h2>Writing some software</h2>
 <p>
-    To take advantage of ev3dev's main functionality, you'll probably need to use a pre-built library from 
-    <a href="libraries">our central list of known libraries</a>.
-
-    <b>TODO</b>
+    To take advantage of ev3dev's main functionality, you'll probably want to
+    use a pre-built library from <a href="/docs/libraries">our central list of
+    known libraries</a>. Choose a language to get started!
 </p>
 
-<!-- that have been developed to simplify developing
-    with ev3dev. If you need to directly program against the ev3dev driver APIs, you can read our
-    info pages on the following topics: -->
-
-<ul>
-    <li>
-        <a href="ports">Input and output ports</a>
-    </li>
-    <li>
-        <a href="sensors">Supported Sensors and Other Input Devices</a>
-    </li>
-    <li>
-        <a href="motors">Supported Motors and Other Output Devices</a>
-    </li>
-    <li>
-        <a href="drivers">ev3dev kernel drivers</a>
-    </li>
-</ul>
+<h3>Low-level driver access</h3>
+<p>
+     If you need to directly program against the ev3dev driver APIs, you can
+     check out our <a href="/docs/driver-access">driver access landing page</a>.
+</p>
 
 <h2>Developing the ev3dev kernel</h2>
 <p>
