diff --git a/engine/swarm/networking.md b/engine/swarm/networking.md
index d5a9783cf3..dd54439dc4 100644
--- a/engine/swarm/networking.md
+++ b/engine/swarm/networking.md
@@ -2,8 +2,13 @@
 description: Use swarm mode overlay networking features
 keywords: swarm, networking, ingress, overlay, service discovery
 title: Manage swarm service networks
+toc_max: 3
 ---
 
+This topic discusses how to manage the application data for your swarm services.
+
+
+## Swarm and types of traffic
 A Docker swarm generates two different kinds of traffic:
 
 - **Control and management plane traffic**: This includes swarm management
@@ -13,9 +18,7 @@ A Docker swarm generates two different kinds of traffic:
 - **Application data plane traffic**: This includes container traffic and
   traffic to and from external clients.
 
-This topic discusses how to manage the application data for your swarm services.
-For more details about swarm networking in general, see the
-[Docker networking reference architecture](https://success.docker.com/Architecture/Docker_Reference_Architecture%3A_Designing_Scalable%2C_Portable_Docker_Container_Networks){: target="_blank" rel="noopener" class="_" }.
+## Key network concepts
 
 The following three network concepts are important to swarm services:
 
@@ -46,6 +49,7 @@ The following three network concepts are important to swarm services:
   join a swarm. Most users do not need to customize its configuration, but
   Docker allows you to do so.
 
+> **See also** [Networking overview](../../network/index.md) for more details about swarm networking in general.
 
 ## Firewall considerations
 
@@ -415,6 +419,6 @@ $ docker swarm join \
 
 * [Deploy services to a swarm](services.md)
 * [Swarm administration guide](admin_guide.md)
-* [Docker CLI reference](../reference/commandline/docker.md)
 * [Swarm mode tutorial](swarm-tutorial/index.md)
-* [Docker networking reference architecture](https://success.docker.com/Architecture/Docker_Reference_Architecture%3A_Designing_Scalable%2C_Portable_Docker_Container_Networks){: target="_blank" rel="noopener" class="_" }
+* [Networking overview](../../network/index.md)
+* [Docker CLI reference](../reference/commandline/docker.md)