diff --git a/circuits/README.md b/circuits/README.md
index ce8ca65c48..cffeccc7a1 100644
--- a/circuits/README.md
+++ b/circuits/README.md
@@ -12,7 +12,7 @@ The main circuits are:
 
 The rest of the circuits are utilities templates that are required for the main circuits to work correctly. These include utilities such as float math, conversion of private keys, and Poseidon hashing/encryption.
 
-Please refer to the [documentation](https://maci.pse.dev/docs/circuits) for a more in depth explanation.
+Please refer to the [documentation](https://maci.pse.dev/docs/category/zk-snark-circuits) for a more in depth explanation.
 
 [circuits-npm-badge]: https://img.shields.io/npm/v/maci-circuits.svg
 [circuits-npm-link]: https://www.npmjs.com/package/maci-circuits
diff --git a/cli/README.md b/cli/README.md
index 211257a2cd..c2f33cf75b 100644
--- a/cli/README.md
+++ b/cli/README.md
@@ -4,7 +4,7 @@
 [![Actions Status][cli-actions-badge]][cli-actions-link]
 
 Please refer to the [documentation for the
-CLI](https://maci.pse.dev/docs/cli).
+CLI](https://maci.pse.dev/docs/developers-references/typescript-code/cli).
 
 [cli-npm-badge]: https://img.shields.io/npm/v/maci-cli.svg
 [cli-actions-badge]: https://github.com/privacy-scaling-explorations/maci/actions/workflows/e2e.yml/badge.svg
diff --git a/contracts/README.md b/contracts/README.md
index eebed2f12e..f3cfee4408 100644
--- a/contracts/README.md
+++ b/contracts/README.md
@@ -5,7 +5,7 @@
 
 This submodule contains all the Ethereum contracts and tests for MACI.
 
-For more information please refer to the [documentation for Contracts](https://maci.pse.dev/docs/contracts).
+For more information please refer to the [documentation for Contracts](https://maci.pse.dev/docs/category/smart-contracts).
 
 [contracts-npm-badge]: https://img.shields.io/npm/v/maci-contracts.svg
 [contracts-npm-link]: https://www.npmjs.com/package/maci-contracts