update name and write readme

1 files changed, 5 insertions, 0 deletions

diff --git a/incria/src/lib.rs b/incria/src/lib.rs
index 2f52fbb..c8c35d6 100644
--- a/incria/src/lib.rs
+++ b/incria/src/lib.rs
@@ -1,4 +1,9 @@
 #![feature(async_fn_in_trait)]
+//! Incria is a library for incremental computation.
+//! It lets you record what a calculation depends on and then only re-run that calculation once one of those dependencies has changed.
+//!
+//! This is similar to the [query system used by the Rust compiler](https://rustc-dev-guide.rust-lang.org/query.html), but implemented using async.
+//! By seperating the tracking of dependencies from the calculation logic, you can write clean code that re-runs only when it needs to, and can be parallelised with little extra work.
 
 pub mod deps;
 mod mapping;