diff --git a/swarm/index.md b/swarm/index.md
index 40d52d27bb..a0b550aab4 100644
--- a/swarm/index.md
+++ b/swarm/index.md
@@ -4,6 +4,13 @@ keywords: docker, swarm,  clustering
 title: Docker Swarm
 ---
 
+This section refers to standalone Docker Swarm. If you use Docker 1.12 or higher,
+[Swarm mode](../engine/swarm/index.md) is integrated with Docker Engine. Most
+users should use the integrated Swarm mode. Standalone Docker Swarm is not
+integrated into the Docker Engine API and CLI commands..
+
+If you decide to use standalone Docker Swarm, use these links to get started.
+
 * [Docker Swarm overview](overview.md)
 * [How to get Docker Swarm](get-swarm.md)
 * [Evaluate Swarm in a sandbox](install-w-machine.md)
@@ -17,4 +24,4 @@ title: Docker Swarm
 * [Swarm and container networks](networking.md)
 * [Advanced Scheduling](scheduler/index.md)
 * [Provision a Swarm cluster with Docker Machine](provision-with-machine.md)
-* [Docker Swarm API](swarm-api.md)
\ No newline at end of file
+* [Docker Swarm API](swarm-api.md)