diff --git a/README.md b/README.md
index 3a07b4e3665fd9bedf13e2baf9957c8e3776c4ee..f1af66eb79cd31422574eea105daded09be271a6 100644
--- a/README.md
+++ b/README.md
@@ -1,15 +1,21 @@
 # Reowolf 1.0 Implementation
 
+This library provides connectors as a generalization of sockets for use in communication over the internet. This repository is one of the deliverables of the [Reowolf project](https://nlnet.nl/project/Reowolf/) funded by the NLNet foundation.
+
 ## Compilation instructions
-1. Install the latest stable Rust toolchain using Rustup. See https://rustup.rs/ for further instructions.
-1. Run `cargo build --release` to download source dependencies, and compile the library with release-level optimizations. 
-	- The resulting dylib can be found in target/release/, to be used with the header file reowolf.h.
-	- Note: A list of immediate ancestor dependencies is visible in Cargo.toml.
-	- Note: Run `cargo test --release` to run unit tests with release-level optimizations.
-
-## Build options
-- `cargo build --release` produces the dylib object, exposing connector API for Rust. The C FFI is also included, and corresponds to the header file `reowolf.h`.
-- `cargo build --release --features ffi_pseudo_socket_api` is only available on Linux, and also generates functions which comprise the pseudo-socket C FFI.
+1. Install the latest stable Rust toolchain (`rustup install stable`) using the [rustup](https://rustup.rs/) CLI tool, available for most platforms.
+1. Have `cargo` (the Rust language package manager) download source dependencies, and compile the library with release-level optimizations with `cargo build --release`: 
+	- The resulting dylib can be found in `./target/release/`, to be used with the header file: `./reowolf.h`.
+	- *Note*: A list of immediate ancestor dependencies is visible in `./Cargo.toml`.
+	- *Note*: Run `cargo test --release` to run unit tests with release-level optimizations.
+
+## Using the library
+- The library may be used as a Rust dependency by adding it as a git dependency, i.e., by adding line `reowolf_rs = { git = "https://scm.cwi.nl/FM/reowolf" }` to downstream crate's manifest file, `Cargo.toml`.
+- The library may be used as a dynamically-linked library using its C ABI as the cdylib written to `./target/release` when compiled with release optimizations, in combination to the header file `./reowolf.h`.
+- When compiled on Linux, the compiled library will include definitions of pseudo-socket procedures declared in `./pseudo-socket.h` when compiled with `cargo build --release --features ffi_pseudo_socket_api`. The added functionality is only needed when requiring that connectors expose a socket-like API.
+
+## Examples
+The `examples` directory contains example usages of connectors for message passing over the internet. The programs within require that the library is compiled as a dylib (see above).
 
 ## Notes
 3. Running `cbindgen > reowolf.h` from the root will overwrite the header file. (WIP) This is only necessary to update it.  
\ No newline at end of file