Improve documentation

Author: lucaong

README.md

@@ -6,8 +6,8 @@
 [![Hex Docs](https://img.shields.io/badge/hex-docs-blue.svg)](https://hexdocs.pm/cubdb/)
 [![License](https://img.shields.io/hexpm/l/cubdb.svg)](https://github.com/lucaong/cubdb/blob/master/LICENSE)
 
-`CubDB` is an embedded key-value database written in the Elixir language. It
-runs locally, it is schema-less, and backed by a single file.
+`CubDB` is an embedded key-value database for the Elixir language. It is
+designed for robustness, and for minimal need of resources.
 
 Head to the [API reference](https://hexdocs.pm/cubdb/CubDB.html) for usage
 details, or read the [Frequently Asked
@@ -17,24 +17,20 @@ section](https://hexdocs.pm/cubdb/howto.html) for more information.
 
 ## Features
 
-  - Both keys and values can be any arbitrary Elixir (or Erlang) term.
+  - Both keys and values can be any Elixir (or Erlang) term.
 
-  - Basic `get`, `put`, and `delete` operations, plus more specialized
-    functions
+  - Basic `get`, `put`, and `delete` operations, selection of ranges of entries
+    sorted by key with `select`.
 
-  - Performant selection of ranges of entries sorted by key with `select`
+  - Atomic, Consistent, Isolated, Durable (ACID) transactions.
 
-  - Atomic transactions
-
-  - Concurrent read operations, that do not block nor are blocked by writes
-
-  - Zero cost read-only snapshots to ensure consistency when reading multiple
-    entries
+  - Multi version concurrency control (MVCC) allowing concurrent read
+    operations, that do not block nor are blocked by writes.
 
   - Unexpected shutdowns or crashes won't corrupt the database or break
-    atomicity
+    atomicity of transactions.
 
-  - Manual or automatic compaction to reclaim disk space
+  - Manual or automatic compaction to reclaim disk space.
 
 To ensure consistency, performance, and robustness to data corruption, `CubDB`
 database file uses an append-only, immutable B-tree data structure. Entries are

lib/cubdb.ex

@@ -1,26 +1,24 @@
 defmodule CubDB do
   @moduledoc """
-  `CubDB` is an embedded key-value database written in the Elixir language. It
-  runs locally, it is schema-less, and backed by a single file.
+  `CubDB` is an embedded key-value database for the Elixir language. It is
+  designed for robustness, and for minimal need of resources.
 
   ## Features
 
-    - Basic `get/3`, `put/3`, and `delete/2` operations, plus more specialized
-      functions
+    - Both keys and values can be any Elixir (or Erlang) term.
 
-    - Performant selection of ranges of entries sorted by key with `select/2`
+    - Basic `get`, `put`, and `delete` operations, selection of ranges of
+    entries sorted by key with `select`.
 
-    - Atomic transactions
+    - Atomic, Consistent, Isolated, Durable (ACID) transactions.
 
-    - Concurrent read operations, that do not block nor are blocked by writes
-
-    - Zero cost read-only snapshots to ensure consistency when reading multiple
-      entries
+    - Multi version concurrency control (MVCC) allowing concurrent read
+    operations, that do not block nor are blocked by writes.
 
     - Unexpected shutdowns or crashes won't corrupt the database or break
-      atomicity
+    atomicity of transactions.
 
-    - Manual or automatic compaction to reclaim disk space
+    - Manual or automatic compaction to reclaim disk space.
 
   To ensure consistency, performance, and robustness to data corruption, `CubDB`
   database file uses an append-only, immutable B-tree data structure. Entries