diff --git a/doc/MACHINE_PREPARATION.md b/doc/MACHINE_PREPARATION.md
index 04b5bf2..8162561 100644
--- a/doc/MACHINE_PREPARATION.md
+++ b/doc/MACHINE_PREPARATION.md
@@ -41,5 +41,5 @@ Otherwise, you might have to set the following variables in your inventory file
  - `docker_storage_vg`
  - `hostpath_provisioner_options`
 
-See the (Sample Partitioning Guide)[doc/SAMPLE_PARTITIONING.md] for a step-by-step guide on how to prepare
+See the [Sample Partitioning Guide](SAMPLE_PARTITIONING.md) for a step-by-step guide on how to prepare
 partitions for OpenShift.
diff --git a/doc/SAMPLE_PARTITIONING.md b/doc/SAMPLE_PARTITIONING.md
index 5166f7f..04d9687 100644
--- a/doc/SAMPLE_PARTITIONING.md
+++ b/doc/SAMPLE_PARTITIONING.md
@@ -13,7 +13,7 @@ It assumes you created a Virtual Machines with three disks :
 `/dev/sda` is partitioned during installation. If possible, use LVM that will
 give you greater flexibility if you need to extend that partition later.
 
-Make sure to **NOT** allocate swap space since it is a (recommended best practice)[https://docs.openshift.com/container-platform/3.5/admin_guide/overcommit.html#disabling-swap-memory].
+Make sure to **NOT** allocate swap space since it is a [recommended best practice](https://docs.openshift.com/container-platform/3.5/admin_guide/overcommit.html#disabling-swap-memory).
 
 After installation, you should have :
  - `/boot` backed by a primary partition, 512 MiB