From facd1f39985af2121def1ce883e802df9edb52d7 Mon Sep 17 00:00:00 2001
From: rdxmb <30314040+rdxmb@users.noreply.github.com>
Date: Thu, 1 Mar 2018 13:21:25 +0100
Subject: [PATCH 1/3] Update index.md

with syntax before, there is
WARN[0000] network hostnet: network.external.name is deprecated in favor of network.name

tested with docker-compose-file-version 3.5
Server Version: 17.12.0-ce

in swarm mode
---
 compose/compose-file/index.md | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/compose/compose-file/index.md b/compose/compose-file/index.md
index 11e467776a1e..2c6fa7b7d904 100644
--- a/compose/compose-file/index.md
+++ b/compose/compose-file/index.md
@@ -2066,8 +2066,7 @@ services:
 
 networks:
   hostnet:
-    external:
-      name: host
+    name: host
 ```
 
 ```yaml
@@ -2079,8 +2078,7 @@ services:
 
 networks:
   nonet:
-    external:
-      name: none
+    name: none
 ```
 
 ### driver_opts

From 45d5c4a97f5e82c14b9a3d5468c422fec86338bc Mon Sep 17 00:00:00 2001
From: rdxmb <30314040+rdxmb@users.noreply.github.com>
Date: Fri, 2 Mar 2018 15:43:51 +0100
Subject: [PATCH 2/3] update new syntax

---
 compose/compose-file/index.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/compose/compose-file/index.md b/compose/compose-file/index.md
index 2c6fa7b7d904..fba629279997 100644
--- a/compose/compose-file/index.md
+++ b/compose/compose-file/index.md
@@ -2066,6 +2066,7 @@ services:
 
 networks:
   hostnet:
+    external: true
     name: host
 ```
 
@@ -2078,6 +2079,7 @@ services:
 
 networks:
   nonet:
+    external: true
     name: none
 ```
 

From 9044688ac77ed307a5842dd63bb48dfd5af3c13d Mon Sep 17 00:00:00 2001
From: Gwendolynne Barr <31074572+gbarr01@users.noreply.github.com>
Date: Wed, 11 Apr 2018 11:37:44 -0700
Subject: [PATCH 3/3] Kick the build

---
 compose/compose-file/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/compose/compose-file/index.md b/compose/compose-file/index.md
index fba629279997..e544b66a5e7f 100644
--- a/compose/compose-file/index.md
+++ b/compose/compose-file/index.md
@@ -2052,7 +2052,7 @@ Use the host's networking stack, or no networking. Equivalent to
 use [network_mode](#network_mode) instead.
 
 The syntax for using built-in networks like `host` and `none` is a little
-different. Define an external network with the name `host` or `none` (which
+different. Define an external network with the name `host` or `none` (that
 Docker has already created automatically) and an alias that Compose can use
 (`hostnet` or `nonet` in these examples), then grant the service access to that
 network, using the alias.