Skip to content

Commit a88736e

Browse files
committed
doc(concepts): small fixes for clarity
1 parent 25a39f3 commit a88736e

1 file changed

Lines changed: 9 additions & 8 deletions

File tree

src/understanding-deis/concepts.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -59,9 +59,10 @@ Applications can come in three forms:
5959
2. as a Dockerfile, which describes how to build your app
6060
3. a reference to an already built Docker Image, hosted on a remote Docker repository
6161

62-
Applications are always given a unique name for easy reference. Workflow also
63-
tracks other related information for your application including any domain
64-
names, SSL Certificates and developer provided configuration.
62+
Applications identified by a unique name for easy reference. If you do not
63+
specify a name when creating your application Workflow generates one for you.
64+
Workflow also tracks other related information for your application including
65+
any domain names, SSL Certificates and developer provided configuration.
6566

6667
## Build, Release, Run
6768

@@ -70,15 +71,15 @@ names, SSL Certificates and developer provided configuration.
7071
### Build Stage
7172

7273
The [builder][] component processes incoming `git push deis master` requests
73-
manages your application packaging.
74+
and manages your application packaging.
7475

7576
If your application is using a [buildpack][] builder will launch an ephemeral
7677
job to extract and execute the packaging instructions. The resulting
7778
application artifact is stored by the platform for execution during the run
7879
stage.
7980

80-
Instead, if you provide a [Dockerfile][dockerfile] builder will use the
81-
instructions you've provided to build a Docker Image. The resulting artifact is
81+
If instead, you provide a [Dockerfile][dockerfile] builder will use the
82+
instructions you have provided to build a Docker Image. The resulting artifact is
8283
stored in a Deis-managed registry which will be referenced during the run
8384
stage.
8485

@@ -105,14 +106,14 @@ Note that during the deploy, your application will be running in a mixed mode.
105106

106107
## Backing Services
107108

108-
Workflow treats all persistent serivces such as databases, caches, storage,
109+
Workflow treats all persistent services such as databases, caches, storage,
109110
messaging systems, and other [backing services][] as resources managed
110111
separtely from your application. This philosophy aligns with Twelve-Factor
111112
best practices.
112113

113114
Applications are attached to backing services using [environment variables][].
114115
Because applications are decoupled from backing services, apps are free to
115-
scale up independently, to swap services provided by other apps, or to switch
116+
scale up independently, to use services provided by other apps, or to switch
116117
to external or third-party vendor services.
117118

118119
## See Also

0 commit comments

Comments
 (0)