diff --git a/docs/readme.md b/docs/readme.md
index 1b132b26f..1bb99f2e9 100644
--- a/docs/readme.md
+++ b/docs/readme.md
@@ -10,6 +10,11 @@ This is where Lokinet documentation lives.
 
 [What Lokinet can't do](we-cannot-make-sandwiches.md)
 
+## Lokinet Internals
+
+[High level layout of the git repo](project-structure.md)
+
+[Build Doxygen Docs for internals](doxygen.md)
 
 ## Lokinet (SN)Application Developer Portal
 
@@ -19,7 +24,4 @@ This is where Lokinet documentation lives.
 [How do I embed lokinet into my application?](liblokinet-dev-guide.md)
 
 
-## Lokinet Internals
-
-[Build Doxygen Docs for internals](doxygen.md)
 
diff --git a/readme.md b/readme.md
index fd5d51cd0..b1b128c2b 100644
--- a/readme.md
+++ b/readme.md
@@ -4,7 +4,7 @@
 
 Lokinet is the reference implementation of LLARP (low latency anonymous routing protocol), a layer 3 onion routing protocol.
 
-You can learn more about the high level design of LLARP [here](docs/)
+You can learn more about the high level, how to use it and the internals of the protocol [here](docs/)
 
 [![Build Status](https://ci.oxen.rocks/api/badges/oxen-io/lokinet/status.svg?ref=refs/heads/dev)](https://ci.oxen.rocks/oxen-io/lokinet)