Add apps README and set --manifest-path in CI

Add apps/README.md documenting the standalone application crates, their structure, and how to run them (cargo xtask examples and notes). Update GitHub Actions CI workflow to pass --manifest-path Cargo.toml to cargo fmt and cargo doc so formatting and docs run correctly from the repository root/workspace manifest.

Author: swgiacomelli

.github/workflows/ci.yml

@@ -40,7 +40,7 @@ jobs:
           toolchain: stable
           components: rustfmt
       - name: Check formatting
-        run: cargo fmt --all -- --check
+        run: cargo fmt --all --manifest-path Cargo.toml -- --check
 
   clippy:
     runs-on: ubuntu-latest
@@ -106,6 +106,6 @@ jobs:
         with:
           toolchain: stable
       - name: Build docs
-        run: cargo doc --no-deps
+        run: cargo doc --manifest-path Cargo.toml --no-deps
         env:
           RUSTDOCFLAGS: -D warnings

apps/README.md

@@ -0,0 +1,49 @@
+# Apps
+
+Standalone application crates for hardware verification and usage examples. These
+crates are not published to crates.io.
+
+---
+
+## Table of Contents
+
+- [Overview](#overview)
+- [Structure](#structure)
+- [Running With `cargo xtask`](#running-with-cargo-xtask)
+- [Notes](#notes)
+
+---
+
+## Overview
+
+The `apps/` directory contains crates that exercise the driver on real ESP32
+hardware. They are intentionally kept out of the main crate to avoid host
+build requirements.
+
+---
+
+## Structure
+
+| Path | Purpose |
+|------|---------|
+| `apps/examples/` | Example applications (esp-hal, smoltcp, embassy-net) |
+| `apps/qa-runner/` | Hardware QA runner for WT32-ETH01 |
+
+---
+
+## Running With `cargo xtask`
+
+Run from the repo root:
+
+```bash
+cargo xtask run ex-embassy-net
+cargo xtask run ex-smoltcp
+cargo xtask run qa-runner
+```
+
+---
+
+## Notes
+
+See `apps/examples/README.md` and `apps/qa-runner/README.md` for details and
+hardware setup.