summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAchilleas Pipinellis <axilleas@axilleas.me>2016-03-13 09:33:10 +0200
committerAchilleas Pipinellis <axilleas@axilleas.me>2016-03-13 09:33:10 +0200
commit49e51753001d0b54adf785792141844c0e89dd70 (patch)
tree43b04543226dc2da56dfb2e87d2e4a26ff906b7b
parent19d1455ac136ab06c2153714761eadfb9ada0f0d (diff)
downloadgitlab-ce-49e51753001d0b54adf785792141844c0e89dd70.tar.gz
Refactor artifacts:name
-rw-r--r--doc/ci/yaml/README.md23
1 files changed, 12 insertions, 11 deletions
diff --git a/doc/ci/yaml/README.md b/doc/ci/yaml/README.md
index a4d621c0e57..83928b81594 100644
--- a/doc/ci/yaml/README.md
+++ b/doc/ci/yaml/README.md
@@ -461,19 +461,16 @@ be available for download in the GitLab UI.
>**Note:**
Introduced in GitLab 8.6 and GitLab Runner v1.1.0.
-The `name` directive allows you to define the name of created artifacts archive.
-
-Currently the `artifacts` is used.
-It may be useful when you will want to download the archive from GitLab.
-You could possible have the unique name of every archive.
-
-The `artifacts:name` variable can use any of the [predefined variables](../variables/README.md).
+The `name` directive allows you to define the name of the created artifacts
+archive. That way, you can have a unique name of every archive which could be
+useful when you'd like to download the archive from GitLab. The `artifacts:name`
+variable can make use of any of the [predefined variables](../variables/README.md).
---
**Example configurations**
-To create a archive with a name of current build:
+To create an archive with a name of the current build:
```yaml
job:
@@ -481,7 +478,8 @@ job:
name: "$CI_BUILD_NAME"
```
-To create a archive with a name of current branch or tag:
+To create an archive with a name of the current branch or tag including only
+the files that are untracked by Git:
```yaml
job:
@@ -490,7 +488,8 @@ job:
untracked: true
```
-To create a archive with a name of current branch or tag:
+To create an archive with a name of the current build and the current branch or
+tag including only the files that are untracked by Git:
```yaml
job:
@@ -499,7 +498,7 @@ job:
untracked: true
```
-To create a archive with a name of stage and branch name:
+To create an archive with a name of the current [stage](#stages) and branch name:
```yaml
job:
@@ -508,6 +507,8 @@ job:
untracked: true
```
+---
+
If you use **Windows Batch** to run your shell scripts you need to replace
`$` with `%`: