more docs, sort examples

README.md

@@ -16,6 +16,20 @@ $ cargo +nightly-2017-04-01 new stm32f100xx --template https://github.com/japari
 Where `stm32f100xx` is the name of the microcontroller family you are
 targeting.
 
+In the Cargo project, you'll have to update the `memory.x` file to reflect the
+memory layout of your device. For example, for the microcontroller in the
+[STM32VLDISCOVERY] which has 128 KB of Flash memory and 8 KB of RAM:
+
+[STM32VLDISCOVERY]: http://www.st.com/en/evaluation-tools/stm32vldiscovery.html
+
+```
+MEMORY
+{
+  FLASH : ORIGIN = 0x08000000, LENGTH = 128K
+  RAM : ORIGIN = 0x20000000, LENGTH = 8K
+}
+```
+
 ## Supported microcontroller families
 
 - nrf51