diff --git a/README.md b/README.md
index fd5eda53..89e9d439 100644
--- a/README.md
+++ b/README.md
@@ -47,7 +47,7 @@ using system logger.
 #### Architecture and internals
 
 Odyssey has sophisticated asynchronous multi-threaded architecture which
-is driven by custom made coroutine engine: [machinarium](https://github.yandex-team.ru/pmwkaa/machinarium).
+is driven by custom made coroutine engine: [machinarium](https://github.yandex-team.ru/pmwkaa/odyssey/tree/master/third_party/machinarium).
 Main idea behind coroutine design is to make event-driven asynchronous applications to look and feel
 like being written in synchronous-procedural manner instead of using traditional
 callback approach.
@@ -60,7 +60,7 @@ More information: [Architecture and internals](documentation/internals.md).
 ### Build instructions
 
 ```sh
-git clone --recursive git://github.yandex-team.ru/pmwkaa/odyssey.git
+git clone git://github.yandex-team.ru/pmwkaa/odyssey.git
 cd odyssey
 mkdir build
 cd build
diff --git a/documentation/internals.md b/documentation/internals.md
index a2a4f550..41f9b55d 100644
--- a/documentation/internals.md
+++ b/documentation/internals.md
@@ -13,7 +13,7 @@ pthreads with coroutine schedulers placed on top of `epoll(7)` event loop.
 Odyssey does not directly use or create multi-tasking primitives such as OS threads and mutexes.
 All synchronization is done using message passing and transparently handled by machinarium.
 
-Repository: [github/machinarium](https://github.yandex-team.ru/pmwkaa/machinarium)
+Repository: [third\_party/machinarium](https://github.yandex-team.ru/pmwkaa/odyssey/tree/master/third_party/machinarium)
 
 #### Shapito
 
@@ -21,7 +21,7 @@ Shapito provides resizable buffers (streams) and methods for constructing, readi
 PostgreSQL protocol requests. By design, all PostgreSQL specific details should be provided by
 Shapito library.
 
-Repository: [third\_party/shapito](https://github.yandex-team.ru/pmwkaa/odyssey/tree/master/third_party/shapito).
+Repository: [third\_party/shapito](https://github.yandex-team.ru/pmwkaa/odyssey/tree/master/third_party/shapito)
 
 #### Core components