diff --git a/compose/compose-file/compose-versioning.md b/compose/compose-file/compose-versioning.md
index a423b09d7d..33480ca334 100644
--- a/compose/compose-file/compose-versioning.md
+++ b/compose/compose-file/compose-versioning.md
@@ -277,6 +277,16 @@ Introduces the following additional parameters:
 - `name` for networks, secrets and configs
 - `shm_size` in [build configurations](index.md#build)
 
+### Version 3.6
+
+An upgrade of [version 3](#version-3) that introduces new parameters. It is
+only available with Docker Engine version **17.12.0** and higher.
+
+Introduces the following additional parameters:
+
+- [`tmpfs`](index.md#tmpfs) in volume definitions using the [Long Syntax](index.md#long-syntax-3)
+- `size` optional parameter for a tmpfs volume
+
 ## Upgrading
 
 ### Version 2.x to 3.x
diff --git a/compose/compose-file/index.md b/compose/compose-file/index.md
index 32fae0c0be..83f3803346 100644
--- a/compose/compose-file/index.md
+++ b/compose/compose-file/index.md
@@ -883,7 +883,17 @@ Mount a temporary file system inside the container. Can be a single value or a l
 
 > **Note**: This option is ignored when
 > [deploying a stack in swarm mode](/engine/reference/commandline/stack_deploy.md)
-> with a (version 3) Compose file.
+> with a (version 3-3.5) Compose file.
+
+> [Version 3.6 file format](compose-versioning.md#version-3) and up.
+
+Mount a temporary file system inside the container. Size parameter specifies the size
+of the tmpfs mount in bytes. Unlimited by default.
+
+     - type: tmpfs
+         target: /app
+         tmpfs:
+           size: 1000
 
 ### entrypoint