docs: add placeholder crate with README.md

Author: erikgrinaker

.gitignore

@@ -1,6 +1,7 @@
 /cluster/toydb*/data
 /data
+/docs/crate/target
 /target
 .DS_Store
 .vscode/
-**/*.rs.bk
+**/*.rs.bk

Cargo.toml

@@ -1,13 +1,14 @@
 [package]
 name = "toydb"
 version = "1.0.0"
-description = "A distributed SQL database"
+description = "A simple distributed SQL database, built for education"
 authors = ["Erik Grinaker <[email protected]>"]
 license = "Apache-2.0"
 homepage = "https://github.com/erikgrinaker/toydb"
 repository = "https://github.com/erikgrinaker/toydb"
 edition = "2024"
 default-run = "toydb"
+publish = false
 
 [lib]
 doctest = false

docs/crate/Cargo.lock

@@ -0,0 +1,9 @@
+[package]
+name = "toydb"
+version = "1.0.0"
+description = "A simple distributed SQL database, built for education"
+authors = ["Erik Grinaker <[email protected]>"]
+license = "Apache-2.0"
+homepage = "https://github.com/erikgrinaker/toydb"
+repository = "https://github.com/erikgrinaker/toydb"
+edition = "2024"

docs/crate/Cargo.toml

@@ -0,0 +1,19 @@
+# toyDB
+
+toyDB is a distributed SQL database in Rust, built from scratch as an educational project. Main
+features:
+
+* Raft distributed consensus for linearizable state machine replication.
+
+* ACID transactions with MVCC-based snapshot isolation.
+
+* Pluggable storage engine with [BitCask][bitcask] and [in-memory][memory] backends.
+
+* Iterator-based query engine with heuristic optimization and time-travel  support.
+
+* SQL interface including joins, aggregates, and transactions.
+
+toyDB is not distributed as a crate, see <https://github.com/erikgrinaker/toydb> for more.
+
+This crate used to contain the [joydb](https://crates.io/crates/joydb) database. Thanks to Serhii
+Potapov for donating the crate name.

docs/crate/README.md

@@ -0,0 +1,2 @@
+//! This crate is just a simple README.md placeholder. toydb is not intended to be used as a
+//! library, and is not distributed as a crate. See <https://github.com/erikgrinaker/toydb>.