diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 105c141e..e098e1fd 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -52,7 +52,7 @@ You can run all the test cases by invoking `make test`.
 The project has a limited set of acceptance tests which are run against a real Proxmox
 instance. These tests are developed alongside the framework-based resource and datasource implementations, and are located in the `fwprovider/tests` directory.
 
-To run the acceptance tests, you need to have a Proxmox instance available. See more details in the [Setup Proxmox for Tests](./howtos/setup-proxmox-for-tests/README.md) section.
+To run the acceptance tests, you need to have a Proxmox instance available. See more details in the [Setup Proxmox for Tests](docs/guides/setup-proxmox-for-tests.md) section.
 Create a `testacc.env` file in the project's root directory with the following contents:
 
 ```env
diff --git a/README.md b/README.md
index 23fd2235..0b9b7c3c 100644
--- a/README.md
+++ b/README.md
@@ -65,7 +65,7 @@ virtual_environment_endpoint = "https://<your-cluster-endpoint>:8006/"
 
 Then run `make example` to deploy the example resources.
 
-If you don't have free proxmox cluster to play with, there is dedicated [how-to tutorial](howtos/setup-proxmox-for-tests/README.md) how to setup Proxmox inside VM and run `make example` on it.
+If you don't have free proxmox cluster to play with, there is dedicated [how-to tutorial](docs/guides/setup-proxmox-for-tests.md) how to setup Proxmox inside VM and run `make example` on it.
 
 ## Future work