diff --git a/README.md b/README.md
index 00106c8..a03ac57 100644
--- a/README.md
+++ b/README.md
@@ -5,31 +5,35 @@
 <br>
 
 <p align="center">
-𝐫𝐮𝐬𝐭𝐥𝐞𝐫 is a web scraping service that scrapes several stock market providers for stock pricing data. It is built using the <code>Rust</code> programming language.
+𝐫𝐮𝐬𝐭𝐥𝐞𝐫 ⫮ 𝐜𝐨𝐫𝐞 is a library that contains the core functionality for `rustler`, a web scraping service that scrapes several stock market providers for stock pricing data. It is built using the <code>Rust</code> programming language.
 </p>
 
 <br>
 <br>
 <br>
 
-## Framweork
+## Why "rustler"
 
-- [Tonic (grpc)](https://docs.rs/tonic/latest/tonic/index.html)
-- websockets:
-  - [tokio-tungstenite](https://docs.rs/tokio-tungstenite/latest/tokio_tungstenite/)
-  - [fastwebsockets](https://crates.io/crates/fastwebsockets)
-  - [embedded-websocket](https://crates.io/crates/embedded-websocket) - bajo nivel - small
-  - [web-socket](https://crates.io/crates/web-socket) - supuestamente el mas rapido
-- Rx Rust:
-  - [rxrust](https://crates.io/crates/rxrust)
-  - [another-rxrust](https://crates.io/crates/another-rxrust) parece un poco mejor
+A `rustler` is a person who steals live***stock***. Well, this library is a service that collects _stock_ market data from the internet. So, it's a "_rustler_" for stock market data.
 
-## Commands
+Also, this library is built using the `Rust` programming language... so, ***rust***ler 😊
 
-```bash
-# add a dependency to a project
-cargo add {dependency} -p {project}
+## What this library includes
 
-# example
-cargo add tokio-tungstenite -p gateway
-```
\ No newline at end of file
+This library defines the core functionality for a `rustler`. It includes the following:
+
+- A `Rustler` trait that defines the core functionality for a `rustler`.
+- A `RustlersSvc` which orchestrates the `rustlers` at runtime, scheduling them to scrape stock pricing data between market hours.
+
+Apart from the above, this library also defines:
+
+- a database schema for storing market hours, which is used by the `RustlersSvc` to schedule the `rustlers`.
+- a grpc service to interact with the rustlers database.
+
+> [!NOTE]
+> 
+> This library defines a _rustler_ as a service that scrapes stock pricing data for a
+> particular market.
+> 
+> Although this library contains the core and abstract functionality for the rustlers, it doesn't include any concrete implementation for them. In other words, this library includes traits and structs that can be used to build a `rustler`).
+> Actual concrete implementations for each market cannot be published for many reasons.
\ No newline at end of file