diff --git a/README.md b/README.md
index 3ba26db71a..464b2fed0a 100644
--- a/README.md
+++ b/README.md
@@ -74,9 +74,6 @@ rm -rf /var/lib/microshift && rm -r $HOME/.microshift
 ```
 ## Deployment Strategies
 
-## [Known Issues](./docs/known-issues.md)
-
-
 1. [Install via an RPM, utilizing a host-provided cri-o runtime and be lifecycle-managed by systemd](https://microshift.io/docs/developer-documentation/build-install-rpm/)
 2. [Install as a container via Podman, utilizing cri-o runtime and be lifecycle-managed by systemd](https://microshift.io/docs/user-documentation/deploying-microshift/containerized/)
 
@@ -84,7 +81,9 @@ For app developer deployments:
 
 1. [Run an all-in-one microshift deployment on which devs can test their applications locally](https://microshift.io/docs/getting-started/experimental-development/).  `microshift-aio` packages cri-o runtime and can be run and managed via podman and systemd
 
-## [Known Issues](https://microshift.io/docs/user-documentation/troubleshooting/)
+## Known Issues
+If issues occur during deployment checkout the troubleshooting document to view fixes of [known issues](https://microshift.io/docs/user-documentation/troubleshooting/).
+
 
 ## Developing MicroShift