Rust Analyzer documentation

Intends to clarify how to make Embassy usable from within Visual Studio Code by assuming the presence of the Rust Analyzer.

Note that IntelliJ does not support the Rust Analyzer, so an open question remains as to the whether this is a good move. If it turns out not to be a good move then we should still look at clarifying the use of a workspace file.

1 files changed, 21 insertions, 4 deletions

diff --git a/README.md b/README.md
index f8898dcd6..fd856bb6d 100644
--- a/README.md
+++ b/README.md
@@ -28,9 +28,10 @@ The `embassy::executor` module provides an async/await executor designed for emb
 
 `embassy::util` contains some lightweight async/await utilities, mainly helpful for async driver development (signaling a task that an interrupt has occured, for example).
 
-## embassy-nrf
+## HALs
 
-The `embassy-nrf` crate contains implementations for nRF 52 series SoCs.
+Hardware Absraction Layers with asynchronous behaviors are provided for a variety of platforms.
+For example, the `embassy-nrf` crate contains implementations for nRF 52 series SoCs.
 
 - `uarte`: UARTE driver implementing `AsyncBufRead` and `AsyncWrite`.
 - `qspi`: QSPI driver implementing `Flash`.
@@ -41,7 +42,8 @@ The `embassy-nrf` crate contains implementations for nRF 52 series SoCs.
 
 ## Examples
 
-Examples are found in the `examples/` folder seperated by the chip manufacturer they are designed to run on:
+Examples are found in the `examples/` folder seperated by the chip manufacturer they are designed to run on. For example:
+
 *   `examples/nrf` are designed to run on the `nrf52840-dk` board (PCA10056) but should be easily adaptable to other nRF52 chips and boards.
 *   `examples/rp` are for the RP2040 chip.
 *   `examples/stm32` are designed for the STM32F429ZI chip but should be easily adaptable to other STM32F4xx chips.
@@ -61,12 +63,27 @@ git submodule update
 cargo install probe-run
 ```
 
+- Change directory to the sample's base directory. For example:
+
+```
+cd examples/nrf
+```
+
 - Run the example
 
+For example:
+
 ```
-cargo run --bin rtc_async
+cargo run --bin blinky
 ```
 
+## Developing Embassy with Rust Analyzer based editors
+
+The [Rust Analyzer](https://rust-analyzer.github.io/) is used by [Visual Studio Code](https://code.visualstudio.com/)
+and others. Given the multiple targets that Embassy serves, there is no Cargo workspace file. Instead, the Rust Analyzer 
+must be told of the target project to work with. In the case of Visual Studio Code, 
+please refer to the `.vscode/settings.json` file's `rust-analyzer.linkedProjects`setting.
+
 ## Minimum supported Rust version (MSRV)
 
 Required nightly version is specified in the `rust-toolchain.toml` file. Nightly is required for: