diff --git a/docs/discovery.md b/docs/discovery.md
index b38cc569f1..f208e2f79b 100644
--- a/docs/discovery.md
+++ b/docs/discovery.md
@@ -208,7 +208,7 @@ And for the `nodes` discovery method.
 
 ## Contributing a new discovery backend
 
-You can contribute a new discovery backend to Swarm. For information on how to do this, see [our discovery README in the Docker Swarm repository](https://github.com/docker/swarm/blob/master/discovery/README.md).
+You can contribute a new discovery backend to Swarm. For information on how to do this, see <a href="https://github.com/docker/swarm/blob/master/discovery/README.md>our discovery README in the Docker Swarm repository</a>.
 
 ## Docker Swarm documentation index
 
diff --git a/docs/scheduler/filter.md b/docs/scheduler/filter.md
index c4ed8c0824..91d592ff67 100644
--- a/docs/scheduler/filter.md
+++ b/docs/scheduler/filter.md
@@ -406,7 +406,7 @@ This filter will prevent scheduling containers on unhealthy nodes.
 
 ## Docker Swarm documentation index
 
-- [User guide](https://docs.docker.com/swarm/)
-- [Discovery options](https://docs.docker.com/swarm/discovery/)
-- [Scheduler strategies](https://docs.docker.com/swarm/scheduler/strategy/)
-- [Swarm API](https://docs.docker.com/swarm/API/)
+- [User guide](/)
+- [Discovery options](/discovery/)
+- [Scheduler strategies](/scheduler/strategy/)
+- [Swarm API](/api/swarm-api)
diff --git a/docs/scheduler/strategy.md b/docs/scheduler/strategy.md
index b9dd2be981..aa2be988a9 100644
--- a/docs/scheduler/strategy.md
+++ b/docs/scheduler/strategy.md
@@ -116,7 +116,10 @@ strategy prefers the node with most containers running.
 
 ## Docker Swarm documentation index
 
-- [User guide](https://docs.docker.com/swarm/)
-- [Discovery options](https://docs.docker.com/swarm/discovery/)
-- [Scheduler filters](https://docs.docker.com/swarm/scheduler/filter/)
-- [Swarm API](https://docs.docker.com/swarm/API/)
+
+- [User guide](/)
+- [Discovery options](/discovery/)
+- [Scheduler strategies](/scheduler/strategy)
+- [Scheduler filters](/scheduler/filter)
+- [Swarm API](/api/swarm-api)
+