From c1c794d3248cb95c9de6cb44a1d920e3fd06bedc Mon Sep 17 00:00:00 2001
From: ddeyo <david.deyo@docker.com>
Date: Mon, 24 Sep 2018 13:52:11 -0700
Subject: [PATCH] topic stubbed and sited

---
 _data/toc.yaml                       |  2 ++
 ee/ucp/deploy-application-package.md | 17 +++++++++++++++++
 2 files changed, 19 insertions(+)
 create mode 100644 ee/ucp/deploy-application-package.md

diff --git a/_data/toc.yaml b/_data/toc.yaml
index f387b2001f..af5057b2f4 100644
--- a/_data/toc.yaml
+++ b/_data/toc.yaml
@@ -1669,6 +1669,8 @@ manuals:
         title: CLI-based access
       - path: /ee/ucp/user-access/kubectl/
         title: Install the Kubernetes CLI
+    - path: /ee/ucp/deploy-application-package
+      title: Deploy an application package
     - sectiontitle: Deploy apps with Swarm
       section:
       - title: Deploy a single service
diff --git a/ee/ucp/deploy-application-package.md b/ee/ucp/deploy-application-package.md
new file mode 100644
index 0000000000..5888ddbac1
--- /dev/null
+++ b/ee/ucp/deploy-application-package.md
@@ -0,0 +1,17 @@
+---
+title: Deploy an appliction package
+description: Learn how to deploy an appliction package in UCP
+keywords: ucp, swarm, kubernetes, application
+---
+
+> Beta disclaimer
+>
+> This is beta content. It is not yet complete and should be considered a work in progress. This content is subject to change without notice.
+
+An application package has one of these formats:
+
+- **Three-file format**: Defined by a metadata.yml, a docker-compose.yml, and a settings.yml files inside a `my-app.dockerapp` folder. This is also called the folder format.
+- **Single-file format**: Defined by a data from the previously three files concatenated in the order givem and separated by `---\n` in a single file named named 'my-app.dockerapp'.
+- **Image format**: Defined by a Docker image in the engine store or exported as a tarball.
+
+The docker-app binary lets a user render an application package to a Compose file using the settings values in the settings file or those specified by the user. This Compose file can then be deployed to a cluster running in Swarm mode or Kubernetes using `docker stack deploy` or to a single engine or Swarm classic cluster using `docker-compose up`.