diff --git a/README.md b/README.md
index e4b49523a..3d55e67d5 100644
--- a/README.md
+++ b/README.md
@@ -35,7 +35,7 @@ Validators and miners are based on large language models (LLM). The validation p
 
 <div align="center">
 
-**[For Validators](./assets/validator.md)** · **[For Miners](./assets/miner.md)** · **[API Documentation]((./docs/API_docs.md))**
+**[For Validators](./docs/validator.md)** · **[For Miners](./docs/epistula_miner.md)** · **[API Documentation]((./docs/API_docs.md))**
 
 
 </div>
diff --git a/neurons/miners/epistula_miner/README.md b/docs/epistula_miner.md
similarity index 100%
rename from neurons/miners/epistula_miner/README.md
rename to docs/epistula_miner.md
diff --git a/assets/validator.md b/docs/validator.md
similarity index 100%
rename from assets/validator.md
rename to docs/validator.md