diff --git a/README.md b/README.md
index ec47be5..8409d48 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,8 @@
 # tg-bot
 
-If you know, you know
\ No newline at end of file
+If you know, you know
+
+- `src/entryPoint.php` is the main entry-point function. It will look through all registered implementation of MessageHandler and take the first one that can handle the message. **Register new message handler here.**
+- `src/MessageHandler.php` is the interface for message handlers.
+- `src/repl.php` is a REPL to send test messages to the entryPoint, intended for quick tests, using PHP CLI.
+- `test/` is for PHPUnit tests. It is quite empty atm and only contain a placeholder.
\ No newline at end of file