README: emphasize on-target tests

Author: newAM

.cargo/config.toml

@@ -33,3 +33,6 @@ unit = "test --features stm32wl5x_cm4,chrono,embedded-time"
 unit-little = "test --features stm32wl5x_cm0p,chrono,embedded-time"
 unit-nucleo = "test -p nucleo-wl55jc-bsp --features stm32wl5x_cm4"
 unit-lora-e5 = "test -p lora-e5-bsp"
+
+[env]
+DEFMT_LOG = "trace"

README.md

@@ -47,17 +47,19 @@ features = [
 
 ## Examples
 
-All examples run on the NUCLEO-WL55JC2. Examples are located in the `examples` crate. The arguments got long for this, so a `run-ex` cargo alias is provided.
+All examples run on the NUCLEO-WL55JC2.
+
+Most examples are written in the form of on-target tests.  See [testsuite/README.md](https://github.com/stm32-rs/stm32wlxx-hal/blob/main/testsuite/README.md) for details.
+
+There are also simple examples located in the `examples` crate. These can be run with the `run-ex` cargo alias:
 
 ```bash
-DEFMT_LOG=trace cargo run-ex gpio-blink
+cargo run-ex gpio-blink
 ```
 
-The on-target tests are also excellent reference material.
-
 ### System Level Example
 
-The testsuites and examples are a good starting point, but they demonstrate features independent of each-other. A system-level example using multiple features simultaneously is provided in a separate repo: [stm32wl-lightswitch-demo](https://github.com/newAM/stm32wl-lightswitch-demo)
+The on-target tests and examples are a good starting point, but they demonstrate features independent of each-other. A system-level example using multiple features simultaneously is provided in a separate repo: [stm32wl-lightswitch-demo](https://github.com/newAM/stm32wl-lightswitch-demo)
 
 ## Unit Tests
 
@@ -67,10 +69,6 @@ Off-target unit tests use the built-in cargo framework. You must specify the tar
 cargo test --features stm32wl5x_cm4
 ```
 
-## On-Target Tests
-
-See [testsuite/README.md](https://github.com/stm32-rs/stm32wlxx-hal/blob/main/testsuite/README.md).
-
 ## Reference Documentation
 
 * [stm32wl5x reference manual](https://www.st.com/resource/en/reference_manual/rm0453-stm32wl5x-advanced-armbased-32bit-mcus-with-subghz-radio-solution-stmicroelectronics.pdf)