From d5b9b8bf0f66fe30bb64a10420a0812889a59754 Mon Sep 17 00:00:00 2001
From: Joffrey F <joffrey@docker.com>
Date: Fri, 28 Sep 2018 12:42:43 -0700
Subject: [PATCH] Update release notes and reference for upcoming Compose
 1.23.0 release

Signed-off-by: Joffrey F <joffrey@docker.com>
---
 compose/reference/config.md     |  3 ++
 release-notes/docker-compose.md | 59 +++++++++++++++++++++++++++++++++
 2 files changed, 62 insertions(+)

diff --git a/compose/reference/config.md b/compose/reference/config.md
index 5292b575f2..5944912d09 100644
--- a/compose/reference/config.md
+++ b/compose/reference/config.md
@@ -14,6 +14,9 @@ Options:
                              anything.
     --services               Print the service names, one per line.
     --volumes                Print the volume names, one per line.
+    --hash="*"               Print the service config hash, one per line.
+                             Set "service1,service2" for a list of specified services
+                             or use the wildcard symbol to display all services
 ```
 
 Validate and view the Compose file.
diff --git a/release-notes/docker-compose.md b/release-notes/docker-compose.md
index 707d3f2a88..35daf979d4 100644
--- a/release-notes/docker-compose.md
+++ b/release-notes/docker-compose.md
@@ -5,6 +5,65 @@ keywords: release notes, compose
 toc_max: 2
 ---
 
+## 1.23.0 (2018-10-10)
+
+### Important note
+
+The default naming scheme for containers created by Compose in this version
+has changed from `<project>_<service>_<index>` to
+`<project>_<service>_<index>_<slug>`, where `<slug>` is a randomly-generated
+hexadecimal string. Please make sure to update scripts relying on the old
+naming scheme accordingly before upgrading.
+
+### Features
+
+- Logs for containers restarting after a crash will now appear in the output
+  of the `up` and `logs` commands.
+
+- Added `--hash` option to the `docker-compose config` command, allowing users
+  to print a hash string for each service's configuration to facilitate rolling
+  updates.
+
+- Output for the `pull` command now reports status / progress even when pulling
+  multiple images in parallel.
+
+- For images with multiple names, Compose will now attempt to match the one
+  present in the service configuration in the output of the `images` command.
+
+### Bugfixes
+
+- Parallel `run` commands for the same service will no longer fail due to name
+  collisions.
+
+- Fixed an issue where paths longer than 260 characters on Windows clients would
+  cause `docker-compose build` to fail.
+
+- Fixed a bug where attempting to mount `/var/run/docker.sock` with
+  Docker Desktop for Windows would result in failure.
+
+- The `--project-directory` option is now used by Compose to determine where to
+  look for the `.env` file.
+
+- `docker-compose build` no longer fails when attempting to pull an image with
+  credentials provided by the gcloud credential helper.
+
+- Fixed the `--exit-code-from` option in `docker-compose up` to always report
+  the actual exit code even when the watched container isn't the cause of the
+  exit.
+
+- Fixed a bug that caused hash configuration with multiple networks to be
+  inconsistent, causing some services to be unnecessarily restarted.
+
+- Fixed a pipe handling issue when using the containerized version of Compose.
+
+- Fixed a bug causing `external: false` entries in the Compose file to be
+  printed as `external: true` in the output of `docker-compose config`
+
+### Miscellaneous
+
+- The `zsh` completion script has been updated with new options, and no
+  longer suggests container names where service names are expected.
+
 ## 1.22.0 (2018-07-17)
 
 ### New features