Milestone Update v0.8.0

Author: James Gober

CHANGELOG.md

@@ -6,6 +6,45 @@ the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html
 
 ## [Unreleased]
 
+## [0.8.0] - 2026-05-19
+
+Examples and guide release. Pure documentation and example
+expansion. No public API changes from `0.7.0`.
+
+### Added
+
+- 8 runnable examples under `examples/`:
+  - `basic` - smallest map/filter pipeline.
+  - `batching` - count-triggered batching with `BatchPolicy`.
+  - `windowing` - tumbling rollup with a deterministic clock.
+  - `dead_letter` - `try_map` + `.dead_letter(sink)` for failure
+    routing.
+  - `threaded` - `ThreadedDriver` via `Pipeline::run_threaded`.
+  - `custom_driver` - implementing the `Driver` trait, wrapping
+    `SyncDriver` with timing instrumentation.
+  - `custom_source` - implementing `Source` for a stateful
+    Fibonacci producer.
+  - `etl` - multi-stage ETL with `ErrorPolicy::Continue`,
+    enrichment lookup, batching, and a counting sink.
+- `[[example]]` entries in `Cargo.toml` with
+  `required-features = ["std"]` for all eight.
+- `docs/GUIDE.md` - 11-section user guide covering the mental
+  model, all closure adapters, custom stage / source / sink /
+  driver implementations, batching, windowing, error policies,
+  dead-letter routing, picking a driver, and common pitfalls.
+- `README.md` gains a Quick start snippet and a Documentation
+  section linking to the guide, API reference, REPS, benches,
+  and examples directory.
+- `docs/README.md` updated to index the new documentation.
+
+### Notes
+
+- All 8 examples build cleanly under
+  `cargo clippy --all-targets --all-features -- -D warnings` and
+  run end-to-end with the expected output.
+- No changes to `src/` or `tests/`; this release is documentation
+  and examples only. Existing 73 tests continue to pass.
+
 ## [0.7.0] - 2026-05-19
 
 Driver trait release. Closes the third (and last) deferral from
@@ -262,7 +301,8 @@ public surface.
   `.dev/` planning structure (DIRECTIVES, ROADMAP, PROMPTS).
 - Crate name reserved on crates.io.
 
-[Unreleased]: https://github.com/jamesgober/pipe-io/compare/v0.7.0...HEAD
+[Unreleased]: https://github.com/jamesgober/pipe-io/compare/v0.8.0...HEAD
+[0.8.0]: https://github.com/jamesgober/pipe-io/compare/v0.7.0...v0.8.0
 [0.7.0]: https://github.com/jamesgober/pipe-io/compare/v0.6.0...v0.7.0
 [0.6.0]: https://github.com/jamesgober/pipe-io/compare/v0.5.0...v0.6.0
 [0.5.0]: https://github.com/jamesgober/pipe-io/compare/v0.4.0...v0.5.0

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "pipe-io"
-version = "0.7.0"
+version = "0.8.0"
 edition = "2021"
 rust-version = "1.75"
 readme = "README.md"
@@ -50,3 +50,35 @@ lto = "thin"
 name = "pipeline"
 harness = false
 required-features = ["std"]
+
+[[example]]
+name = "basic"
+required-features = ["std"]
+
+[[example]]
+name = "batching"
+required-features = ["std"]
+
+[[example]]
+name = "windowing"
+required-features = ["std"]
+
+[[example]]
+name = "dead_letter"
+required-features = ["std"]
+
+[[example]]
+name = "threaded"
+required-features = ["std"]
+
+[[example]]
+name = "custom_driver"
+required-features = ["std"]
+
+[[example]]
+name = "custom_source"
+required-features = ["std"]
+
+[[example]]
+name = "etl"
+required-features = ["std"]

Cargo.toml

@@ -10,6 +10,7 @@
     <a href="https://crates.io/crates/pipe-io"><img alt="crates.io" src="https://img.shields.io/crates/v/pipe-io.svg"></a>
     <a href="https://crates.io/crates/pipe-io"><img alt="downloads" src="https://img.shields.io/crates/d/pipe-io.svg"></a>
     <a href="https://docs.rs/pipe-io"><img alt="docs.rs" src="https://docs.rs/pipe-io/badge.svg"></a>
+    <a href="https://github.com/rust-lang/rfcs/blob/master/text/2495-min-rust-version.md" title="MSRV"><img alt="MSRV" src="https://img.shields.io/badge/MSRV-1.75%2B-blue"></a>
     <a href="https://github.com/jamesgober/pipe-io/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/jamesgober/pipe-io/actions/workflows/ci.yml/badge.svg"></a>
 </p>
 
@@ -22,6 +23,41 @@
 
 Typed source-transform-sink pipelines with backpressure, batching, windowing, and per-stage error isolation. A lightweight runtime-agnostic stream processor for in-process workloads. The missing middle ground between raw iterators and full distributed stream processing.
 
+## Quick start
+
+```rust
+use pipe_io::{Pipeline, sink::VecSink};
+
+let sink = VecSink::<i64>::new();
+let handle = sink.handle();
+
+Pipeline::from_iter(1..=5)
+    .map(|n: i32| i64::from(n) * 10)
+    .filter(|n: &i64| *n > 20)
+    .sink(sink)
+    .run()
+    .expect("pipeline run");
+
+assert_eq!(handle.take(), vec![30, 40, 50]);
+```
+
+## Documentation
+
+- [Quick reference (`docs/API.md`)](docs/API.md)
+- [User guide (`docs/GUIDE.md`)](docs/GUIDE.md) - patterns and how-tos
+- [Project specification (`REPS.md`)](REPS.md) - locked public surface
+- [Benchmarks (`docs/BENCH.md`)](docs/BENCH.md) - measured throughput
+- [Examples](examples/) - 8 runnable examples covering batching,
+  windowing, dead-letter routing, threaded execution, and custom
+  drivers/sources
+
+Run any example with `cargo run --example <name>`, for instance:
+
+```text
+cargo run --example basic
+cargo run --example etl
+```
+
 ## License
 
 Licensed under the Apache License, Version 2.0. See [`LICENSE`](LICENSE)