From 4af9aabdf4769c7c9d577d7fa0a3722fd8da263b Mon Sep 17 00:00:00 2001
From: Robin Mueller <robin.mueller.m@gmail.com>
Date: Tue, 1 Oct 2024 10:53:16 +0200
Subject: [PATCH] README and docs update

---
 vorago-peb1/README.md  | 15 ++++++---------
 vorago-peb1/src/lib.rs |  4 ++++
 2 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/vorago-peb1/README.md b/vorago-peb1/README.md
index 59de734..591201c 100644
--- a/vorago-peb1/README.md
+++ b/vorago-peb1/README.md
@@ -1,15 +1,12 @@
+[![Crates.io](https://img.shields.io/crates/v/vorago-peb1)](https://crates.io/crates/vorago-peb1)
+[![docs.rs](https://img.shields.io/docsrs/vorago-peb1)](https://docs.rs/vorago-peb1)
+
 # Rust BSP for the Vorago PEB1 development board
 
-## Using the `.cargo/config.toml` file
+This is the Rust **B**oard **S**upport **P**ackage crate for the Vorago PEB1 development board.
+Its aim is to provide drivers for the board features of the PEB1 board.
 
-Use the following command to have a starting `config.toml` file
-
-```sh
-cp .cargo/def-config.toml .cargo/config.toml
-```
-
-You then can adapt the `config.toml` to your needs. For example, you can configure runners
-to conveniently flash with `cargo run`.
+The BSP builds on top of the [HAL crate for VA416xx devices](https://egit.irs.uni-stuttgart.de/rust/va416xx-rs/src/branch/main/va416xx-hal).
 
 ## Notes on board revisions
 
diff --git a/vorago-peb1/src/lib.rs b/vorago-peb1/src/lib.rs
index fe12701..06243f2 100644
--- a/vorago-peb1/src/lib.rs
+++ b/vorago-peb1/src/lib.rs
@@ -5,6 +5,10 @@
 pub use lis2dh12;
 
 /// Support for the LIS2DH12 accelerometer on the GPIO board.
+///
+/// # Example
+///
+/// - [PEB1 Accelerometer](https://egit.irs.uni-stuttgart.de/rust/va416xx-rs/src/branch/main/examples/simple/examples/peb1-accelerometer.rs)
 pub mod accelerometer {
 
     use lis2dh12::{self, detect_i2c_addr, AddrDetectionError, Lis2dh12};