JoshuaChi · Jan 1, 2026 · Apr 19, 2025 · Apr 20, 2025 · Apr 20, 2025 · Apr 22, 2025
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,7 +4,7 @@ All notable changes to this project will be documented in this file.
 
 ---
 
-## [v0.2.0] - 2025-12-11 [✅ Released]
+## [v0.2.0] - 2026-01-01 [✅ Released]
 
 ### 🎯 Highlights for Developers
 

diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -4,13 +4,12 @@ members = [
   "d-engine-proto",
   "d-engine-core",
   "d-engine-client",
-  "d-engine-docs",
   "d-engine-server"
 ]
 
 exclude = [
+  "docs",
   "examples/client_usage",
-  "examples/rocksdb-cluster",
   "examples/sled-cluster",
   "examples/three-nodes-cluster",
   "examples/single-node-expansion",
@@ -32,10 +31,10 @@ repository = "https://github.com/deventlab/d-engine"
 license = "MIT OR Apache-2.0"
 
 [workspace.dependencies]
-d-engine-proto = { path = "./d-engine-proto" }
-d-engine-core = { path = "./d-engine-core" }
-d-engine-client = { path = "./d-engine-client" }
-d-engine-server = { path = "./d-engine-server" }
+d-engine-proto = { path = "./d-engine-proto", version = "0.2.0" }
+d-engine-core = { path = "./d-engine-core", version = "0.2.0" }
+d-engine-client = { path = "./d-engine-client", version = "0.2.0" }
+d-engine-server = { path = "./d-engine-server", version = "0.2.0" }
 
 tokio = { version = "1", features = [
     "macros",

diff --git a/Makefile b/Makefile
@@ -35,7 +35,7 @@ RUST_LOG_LEVEL ?= d_engine_server=debug,d_engine_core=debug,d_engine_client=debu
 RUST_BACKTRACE ?= 1
 
 # Workspace member crates
-WORKSPACE_MEMBERS := d-engine-proto d-engine-core d-engine-client d-engine-server d-engine-docs d-engine
+WORKSPACE_MEMBERS := d-engine-proto d-engine-core d-engine-client d-engine-server d-engine
 
 # Color codes for formatted output
 RED := \033[0;31m
@@ -382,19 +382,19 @@ bench-gate: check-workspace
 ## docs                Generate API documentation and open in browser (opens d-engine API hub)
 docs: check-workspace
 	@echo "$(BLUE)Generating API documentation for public crates...$(NC)"
-	@$(CARGO) doc --package d-engine --package d-engine-docs --no-deps \
+	@$(CARGO) doc --package d-engine --no-deps \
 		--features "d-engine/client,d-engine/server,d-engine/rocksdb,d-engine/watch"
 	@echo "$(GREEN)✓ Documentation generated$(NC)"
-	@echo "$(CYAN)Opening documentation hub at: target/doc/d_engine_docs/index.html$(NC)"
-	@open "file://$$(pwd)/target/doc/d_engine_docs/index.html" 2>/dev/null || xdg-open "file://$$(pwd)/target/doc/d_engine_docs/index.html" 2>/dev/null || echo "Please open: target/doc/d_engine_docs/index.html"
+	@echo "$(CYAN)Opening documentation at: target/doc/d_engine/index.html$(NC)"
+	@open "file://$$(pwd)/target/doc/d_engine/index.html" 2>/dev/null || xdg-open "file://$$(pwd)/target/doc/d_engine/index.html" 2>/dev/null || true
 
 ## docs-all             Generate documentation with all features enabled
 docs-all: check-workspace
 	@echo "$(BLUE)Generating API documentation (all features)...$(NC)"
 	@$(CARGO) doc --workspace --all-features --no-deps
 	@echo "$(GREEN)✓ Documentation generated$(NC)"
-	@echo "$(CYAN)Opening documentation hub at: target/doc/d_engine_docs/index.html$(NC)"
-	@open "file://$$(pwd)/target/doc/d_engine_docs/index.html" 2>/dev/null || xdg-open "file://$$(pwd)/target/doc/d_engine_docs/index.html" 2>/dev/null || echo "Please open: target/doc/d_engine_docs/index.html"
+	@echo "$(CYAN)Opening documentation at: target/doc/d_engine/index.html$(NC)"
+	@open "file://$$(pwd)/target/doc/d_engine/index.html" 2>/dev/null || xdg-open "file://$$(pwd)/target/doc/d_engine/index.html" 2>/dev/null || true
 
 ## docs-check           Check documentation without opening browser (CI-safe)
 docs-check: check-workspace

diff --git a/README.md b/README.md
@@ -12,26 +12,6 @@ with pluggable storage backends, built-in observability, and tokio runtime suppo
 
 ---
 
-## 🚧 Project Status
-
-d-engine is in **active development** (pre-1.0).
-
-**For Production Use**:
-
-- ✅ Core Raft consensus is stable (1000+ integration tests, Jepsen validated)
-- ✅ API surface is stabilizing (v0.2.0 focuses on developer experience)
-- ⚠️ Pre-1.0: Breaking changes may occur between minor versions (e.g., v0.2 → v0.3)
-- 📋 [Semantic Versioning](https://semver.org/) will strictly apply after v1.0
-
-**Compatibility Promise**:
-
-- **Before v1.0**: Breaking changes documented in [MIGRATION_GUIDE.md](./MIGRATION_GUIDE.md)
-- **After v1.0**: Breaking changes only in major versions (v1.x → v2.0)
-
-**Current Focus**: API stabilization for v1.0 release (Q2 2026)
-
----
-
 ## Features
 
 ### New in v0.2.0 🎉

diff --git a/benches/d-engine-bench/README.md b/benches/d-engine-bench/README.md
@@ -12,7 +12,7 @@ Ensure you're using the correct d-engine version in your `Cargo.toml`:
 
 ```toml
 [dependencies]
-d-engine = "0.1.2"  # Verify latest version
+d-engine = "0.2.0"  # Verify latest version
 ```
 
 ### 2. Setup Cluster

diff --git a/benches/d-engine-bench/reports/v0.2.0/report_v0.2.0_final.md b/benches/d-engine-bench/reports/v0.2.0/report_v0.2.0_final.md
@@ -8,7 +8,7 @@
 - ⚠️ **Read**: etcd 11.7x faster in linearizable reads (hardware difference)
 - ✅ **Unique**: LeaseRead provides 6.9x performance vs linearizable with strong consistency
 
-**vs v0.1.4**:
+**vs v0.2.0**:
 
 - ✅ **All scenarios improved** 2.3% to 11% throughput
 - ✅ **LeaseRead p99**: -44% latency (7.87ms vs 14.05ms) - biggest win

diff --git a/d-engine-client/Cargo.toml b/d-engine-client/Cargo.toml
@@ -3,13 +3,13 @@ name = "d-engine-client"
 version.workspace = true
 edition.workspace = true
 authors.workspace = true
-description = "Client library for connecting to d-engine Raft consensus servers"
+description = "Client library for interacting with d-engine Raft clusters via gRPC"
 homepage.workspace = true
 repository.workspace = true
 license.workspace = true
 keywords = ["raft", "consensus", "client", "async"]
 categories = ["asynchronous", "network-programming"]
-publish = false
+publish = true
 
 [package.metadata.docs.rs]
 all-features = true

diff --git a/d-engine-client/README.md b/d-engine-client/README.md
@@ -0,0 +1,43 @@
+# d-engine-client
+
+[![Crates.io](https://img.shields.io/crates/v/d-engine-client.svg)](https://crates.io/crates/d-engine-client)
+[![docs.rs](https://docs.rs/d-engine-client/badge.svg)](https://docs.rs/d-engine-client)
+
+Client library for interacting with d-engine Raft clusters
+
+---
+
+## ⚠️ You Probably Don't Need This Crate
+
+**Use [`d-engine`](https://crates.io/crates/d-engine) instead:**
+
+```toml
+[dependencies]
+d-engine = { version = "0.2", features = ["client"] }
+```
+
+This provides the same API with simpler dependency management. The `d-engine-client` crate is automatically included when you enable the `client` feature.
+
+---
+
+## For Contributors
+
+This crate exists for architectural reasons:
+
+- **Clean boundaries** - Separates client logic from server implementation
+- **Faster builds** - Workspace members can depend on client without pulling server deps
+- **Testing** - Enables isolated client testing
+
+If you're building an application, use `d-engine` with `features = ["client"]` instead.
+
+---
+
+## Quick Reference
+
+See [`d-engine` README](https://github.com/deventlab/d-engine/blob/main/README.md) for usage examples and documentation.
+
+---
+
+## License
+
+MIT or Apache-2.0
diff --git a/d-engine-client/src/lib.rs b/d-engine-client/src/lib.rs
@@ -1,46 +1,68 @@
-//! Client module for distributed consensus system
+//! # d-engine-client
 //!
-//! Provides core components for interacting with the d_engine cluster:
-//! - [`Client`] - Main entry point with cluster access
-//! - [`ClientBuilder`] - Configurable client construction
-//! - [`KvClient`] - Key-value store operations
-//! - [`ClusterClient`] - Cluster management operations
-//! - [`ConnectionPool`] - Underlying connection management
+//! Client library for interacting with d-engine Raft clusters via gRPC
+//!
+//! ## ⚠️ You Probably Don't Need This Crate
+//!
+//! **Use [`d-engine`](https://crates.io/crates/d-engine) instead:**
+//!
+//! ```toml
+//! [dependencies]
+//! d-engine = { version = "0.2", features = ["client"] }
+//! ```
+//!
+//! This provides the same API with simpler dependency management. The `d-engine-client` crate
+//! is automatically included when you enable the `client` feature.
+//!
+//! ## For Contributors
 //!
-//! # Basic Usage
-//! ```no_run
+//! This crate exists for architectural reasons:
+//! - Clean boundaries between client and server
+//! - Faster builds during development
+//! - Isolated client testing
+//!
+//! ## Quick Start
+//!
+//! ```rust,ignore
 //! use d_engine_client::Client;
-//! use d_engine_client::ClientBuilder;
-//! use std::time::Duration;
-//! use core::error::Error;
-//!
-//! #[tokio::main(flavor = "current_thread")]
-//! async fn main(){
-//!     // Initialize client with automatic cluster discovery
-//!     let client = Client::builder(vec![
-//!         "http://node1:9081".into(),
-//!         "http://node2:9082".into()
-//!     ])
-//!     .connect_timeout(Duration::from_secs(3))
-//!     .request_timeout(Duration::from_secs(1))
-//!     .enable_compression(true)
-//!     .build()
-//!     .await
-//!     .unwrap();
-//!
-//!     // Execute key-value operations
-//!     client.kv().put("user:1001", "Alice").await.unwrap();
-//!
-//!     let value = client.kv().get("user:1001").await.unwrap();
-//!
-//!     println!("User data: {:?}", value);
-//!
-//!     // Perform cluster management
-//!     let members = client.cluster().list_members().await.unwrap();
-//!     println!("Cluster members: {:?}", members);
 //!
+//! #[tokio::main]
+//! async fn main() -> Result<(), Box<dyn std::error::Error>> {
+//!     let client = Client::connect(vec!["http://localhost:50051"]).await?;
+//!
+//!     // Write data
+//!     client.put(b"key".to_vec(), b"value".to_vec()).await?;
+//!
+//!     // Read data
+//!     if let Some(value) = client.get(b"key".to_vec()).await? {
+//!         println!("Value: {:?}", value);
+//!     }
+//!
+//!     Ok(())
 //! }
 //! ```
+//!
+//! ## Read Consistency
+//!
+//! Choose consistency level based on your needs:
+//!
+//! - `get_linearizable()` - Strong consistency (read from Leader)
+//! - `get_eventual()` - Fast local reads (stale OK)
+//! - `get_lease()` - Optimized with leader lease
+//!
+//! ## Features
+//!
+//! This crate provides:
+//! - [`Client`] - Main entry point with cluster access
+//! - [`ClientBuilder`] - Configurable client construction
+//! - [`KvClient`] - Key-value store operations trait
+//! - [`ClusterClient`] - Cluster management operations
+//!
+//! ## Documentation
+//!
+//! For comprehensive guides:
+//! - [Read Consistency](https://docs.rs/d-engine/latest/d_engine/docs/client_guide/read_consistency/index.html)
+//! - [Error Handling](https://docs.rs/d-engine/latest/d_engine/docs/client_guide/error_handling/index.html)
 
 mod builder;
 mod cluster;

diff --git a/d-engine-core/Cargo.toml b/d-engine-core/Cargo.toml
@@ -3,13 +3,13 @@ name = "d-engine-core"
 version.workspace = true
 edition.workspace = true
 authors.workspace = true
-description = "Core Raft consensus algorithm implementation and traits"
+description = "Pure Raft consensus algorithm - for building custom Raft-based systems"
 homepage.workspace = true
 repository.workspace = true
 license.workspace = true
 keywords = ["raft", "consensus", "algorithm"]
 categories = ["algorithms", "concurrency"]
-publish = false
+publish = true
 
 [package.metadata.docs.rs]
 all-features = true

diff --git a/d-engine-core/README.md b/d-engine-core/README.md
@@ -0,0 +1,69 @@
+# d-engine-core
+
+[![Crates.io](https://img.shields.io/crates/v/d-engine-core.svg)](https://crates.io/crates/d-engine-core)
+[![docs.rs](https://docs.rs/d-engine-core/badge.svg)](https://docs.rs/d-engine-core)
+
+Pure Raft consensus algorithm - for building custom Raft-based systems
+
+---
+
+## ⚠️ Internal Crate - Not Ready for Standalone Use
+
+**Use [`d-engine`](https://crates.io/crates/d-engine) instead.**
+
+This crate contains the pure Raft consensus algorithm used internally by d-engine. The API is unstable before v1.0.
+
+```toml
+# ❌ Don't use this directly
+[dependencies]
+d-engine-core = "0.2"
+
+# ✅ Use this instead
+[dependencies]
+d-engine = "0.2"
+```
+
+---
+
+## For Contributors
+
+This crate provides the core Raft consensus algorithm:
+
+- **Leader Election** - Automatic leader election with randomized timeouts
+- **Log Replication** - Reliable log replication to followers
+- **Membership Changes** - Dynamic cluster membership (add/remove nodes)
+- **Snapshot Support** - Log compaction via snapshots
+
+**Reference integration**: See how [d-engine-server](https://github.com/deventlab/d-engine/tree/main/d-engine-server) uses this crate.
+
+**Key traits to understand**:
+
+- `StorageEngine` - Persistent storage for Raft logs
+- `StateMachine` - Application-specific state transitions
+- `LogStore` - Log entry persistence
+- `MetaStore` - Metadata persistence (term, voted_for)
+
+See the [API documentation](https://docs.rs/d-engine-core) for detailed trait definitions.
+
+---
+
+## Future Vision
+
+**Post-1.0 goal**: Become a standalone Raft library with stable API.
+
+**Current status**: Internal to d-engine, API may change between minor versions.
+
+---
+
+## Documentation
+
+For understanding d-engine internals:
+
+- [Customize Storage Engine](https://docs.rs/d-engine/latest/d_engine/docs/server_guide/customize_storage_engine/index.html)
+- [Customize State Machine](https://docs.rs/d-engine/latest/d_engine/docs/server_guide/customize_state_machine/index.html)
+
+---
+
+## License
+
+MIT or Apache-2.0
-Original file line number
+Diff line change
@@ Expand Up @@
     ---
-    ## [v0.2.0] - 2025-12-11 [✅ Released]
+    ## [v0.2.0] - 2026-01-01 [✅ Released]
     ### 🎯 Highlights for Developers
@@ Expand Down @@