hardware: Fix up board pages.

Make the following changes to each of the board files under
source/hardware/:

- Link to ST docs from MCU name in Technical Specifications.
- Tweak RM0008 description.
- Beautify technical specifications.
- Note that pin maps aren't exhaustive.

It's becoming clear that we should eventually use some kind of
templating language to get these pages done, but it's still overkill
for now.

1 files changed, 18 insertions, 12 deletions

diff --git a/source/hardware/maple-mini.rst b/source/hardware/maple-mini.rst
index 665970a..6f3f437 100644
--- a/source/hardware/maple-mini.rst
+++ b/source/hardware/maple-mini.rst
@@ -15,25 +15,26 @@ breadboard.
 Technical Specifications
 ------------------------
 
-* MCU: **STM32F103RCBT6**, a 32-bit ARM Cortex M3 microprocessor
+* MCU: :ref:`STM32F103RCBT6 <maple-mini-stdocs>`, a 32-bit ARM Cortex
+  M3 microprocessor
 * Clock Speed: **72 MHz**
 * **128 KB Flash** and **20 KB SRAM**
-* 34 Digital I/O Pins (:ref:`gpio`)
-* 12 **PWM** pins at 16 bit resolution (:ref:`pwm`)
-* 9 analog input pins, 12 bit **ADC** resolution (:ref:`adc`)
-* 2 **SPI** peripherals (:ref:`spi`)
-* 2 **I2C** peripherals (:ref:`i2c`)
+* 34 :ref:`digital I/ pins (GPIOs) <gpio>`
+* 12 :ref:`PWM <pwm>` pins at 16 bit resolution
+* 9 :ref:`analog input (ADC) <adc>` pins at 12 bit resolution
+* 2 :ref:`SPI <spi>` peripherals
+* 2 :ref:`I2C <i2c>` peripherals
 * 7 Channels of Direct Memory Access (**DMA**) (:ref:`libmaple-dma`)
-* 3 **USART** peripherals (:ref:`usart`)
-* 1 advanced and 3 general-purpose **timers** (:ref:`timers`)
-* Dedicated **USB** port for programming and communications (:ref:`usb`)
-* **JTAG** (:ref:`jtag`)
+* 3 :ref:`USART (serial port) <usart>` peripherals
+* 1 advanced and 3 general-purpose :ref:`timers <timers>`
+* Dedicated :ref:`USB <usb>` port for programming and communications
+* :ref:`jtag`
 * Nested Vectored Interrupt Controller (NVIC) (including
   :ref:`external interrupt <external-interrupts>` on GPIOs)
 * Supplies up to 500 mA at 3.3 V, with :ref:`separate 250 mA digital
   and analog regulators <maple-mini-adc-bank>` for low-noise analog
   performance
-* :ref:`Four layer design <maple-mini-hardware>`
+* :ref:`Open source, four layer design <maple-mini-hardware>`
 * Support for low power, sleep, and standby modes (<500 μA)
 * Operating Voltage: 3.3 V
 * Input Voltage (recommended): 3 V — 12 V
@@ -97,6 +98,9 @@ This table shows a summary the available functionality on every GPIO
 pin, by peripheral type.  The "5 V?" column documents whether or not
 the pin is :ref:`5 volt tolerant <gpio-5v-tolerant>`.
 
+Note that this table is not exhaustive; on some pins, more peripherals
+are available than are listed here.
+
 .. csv-table::
    :header: Pin, :ref:`GPIO <gpio>`, :ref:`ADC <adc>`, :ref:`Timer <timers>`, :ref:`I2C <i2c>`, :ref:`UART <usart>`, :ref:`SPI <spi>`, 5 V?
 
@@ -347,6 +351,8 @@ This section lists known issues and warnings for the Maple Mini Rev 2
 Recommended Reading
 -------------------
 
+.. _maple-mini-stdocs:
+
 STMicro documentation for STM32F103CB microcontroller:
 
 * `Datasheet
@@ -354,7 +360,7 @@ STMicro documentation for STM32F103CB microcontroller:
   (PDF); covers STM32F103x8, STM32F103xB.
 * `Reference Manual RM0008
   <http://www.st.com/internet/com/TECHNICAL_RESOURCES/TECHNICAL_LITERATURE/REFERENCE_MANUAL/CD00171190.pdf>`_
-  (PDF); general, definitive resource for STM32F1 line.
+  (PDF); definitive resource for peripherals on the STM32F1 line.
 * `Programming Manual PM0056
   <http://www.st.com/internet/com/TECHNICAL_RESOURCES/TECHNICAL_LITERATURE/PROGRAMMING_MANUAL/CD00228163.pdf>`_
   (PDF); assembly language and register reference.