diff --git a/Cargo.toml b/Cargo.toml
index def49bd..53ab994 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -5,8 +5,8 @@ edition = "2024"
 rust-version = "1.90"
 description = "Code-review gate for CI and coding agents: asks TypeSafe Jev small questions about functions, files, tests and docs, and reports maintainability, test, security and documentation findings with locations and probabilities"
 repository = "https://github.com/Tech-Byte-Frontier/jevgate"
-homepage = "https://github.com/Tech-Byte-Frontier/jevgate"
-documentation = "https://github.com/Tech-Byte-Frontier/jevgate#readme"
+homepage = "https://tech-byte-frontier.github.io/jevgate/"
+documentation = "https://tech-byte-frontier.github.io/jevgate/"
 readme = "README.md"
 keywords = ["code-review", "ci", "static-analysis", "maintainability", "security"]
 categories = ["command-line-utilities", "development-tools"]
diff --git a/README.md b/README.md
index de8ce34..4ccbcab 100644
--- a/README.md
+++ b/README.md
@@ -22,6 +22,7 @@ Consider (2):
     → Pass the values as bound query parameters
 ```
 
+- **[Documentation site](https://tech-byte-frontier.github.io/jevgate/)**: guides, troubleshooting and the full rule, configuration and command-line reference
 - [What it finds](#what-it-finds)
 - [Supported languages and frameworks](#supported-languages-and-frameworks)
 - [Install](#install)