diff --git a/docs/architecture.md b/docs/architecture.md
index 2aa12187..ff12f91c 100644
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -144,7 +144,7 @@ spec:
   callbacks: {"name" → {…}, …}
 ```
 
-Check out the [OAS](/install/crd/authorino.kuadrant.io_authconfigs.yaml) of the `AuthConfig` CRD for a formal specification of the options for `authentication` verification, external `metadata` fetching, `authorization` policies, and dynamic `response`, as well as any other host protection capability implemented by Authorino.
+Check out the [OAS](../install/crd/authorino.kuadrant.io_authconfigs.yaml) of the `AuthConfig` CRD for a formal specification of the options for `authentication` verification, external `metadata` fetching, `authorization` policies, and dynamic `response`, as well as any other host protection capability implemented by Authorino.
 
 You can also read the specification from the CLI using the [`kubectl explain`](https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#explain) command. The Authorino CRD is required to have been installed in Kubernetes cluster. E.g. `kubectl explain authconfigs.spec.authentication.overrides`.
 
diff --git a/docs/contributing.md b/docs/contributing.md
index 0442f4eb..5f59a61e 100644
--- a/docs/contributing.md
+++ b/docs/contributing.md
@@ -59,7 +59,7 @@ Good changes...
 
 - follow the [Golang conventions](https://golang.org/doc/effective_go)
 - have proper test coverage
-- address corresponding updates to the [docs](./)
+- address corresponding updates to the [docs](./README.md)
 - help us fix wherever we failed to do the above 😜
 
 ### Run the tests
diff --git a/docs/user-guides/deny-with-redirect-to-login.md b/docs/user-guides/deny-with-redirect-to-login.md
index 928b5c6e..b0ebbe0e 100644
--- a/docs/user-guides/deny-with-redirect-to-login.md
+++ b/docs/user-guides/deny-with-redirect-to-login.md
@@ -14,7 +14,7 @@ Customize response status code and headers on failed requests to redirect users
 
   Authorino's default response status codes, messages and headers for unauthenticated (`401`) and unauthorized (`403`) requests can be customized with static values and values fetched from the [Authorization JSON](../architecture.md#the-authorization-json).
 
-  Check out as well the user guides about [HTTP "Basic" Authentication (RFC 7235)](user-guides/http-basic-authentication.md) and [OpenID Connect Discovery and authentication with JWTs](oidc-jwt-authentication.md).
+  Check out as well the user guides about [HTTP "Basic" Authentication (RFC 7235)](http-basic-authentication.md) and [OpenID Connect Discovery and authentication with JWTs](oidc-jwt-authentication.md).
 
   For further details about Authorino features in general, check the [docs](../features.md).
 </details>