diff --git a/docs/docs/20-usage/20-pipeline-syntax.md b/docs/docs/20-usage/20-pipeline-syntax.md index 67da3fe67..6f9b1a9bf 100644 --- a/docs/docs/20-usage/20-pipeline-syntax.md +++ b/docs/docs/20-usage/20-pipeline-syntax.md @@ -139,7 +139,7 @@ Example configuration using a private image: - go test ``` -Woodpecker matches the registry hostname to each image in your yaml. If the hostnames match, the registry credentials are used to authenticate to your registry and pull the image. Note that registry credentials are used by the Woodpecker agent and are never exposed to your build containers. +Woodpecker matches the registry hostname to each image in your YAML. If the hostnames match, the registry credentials are used to authenticate to your registry and pull the image. Note that registry credentials are used by the Woodpecker agent and are never exposed to your build containers. Example registry hostnames: @@ -510,7 +510,7 @@ For more details check the [services docs](./60-services.md). ## `workspace` -The workspace defines the shared volume and working directory shared by all pipeline steps. The default workspace matches the below pattern, based on your repository url. +The workspace defines the shared volume and working directory shared by all pipeline steps. The default workspace matches the below pattern, based on your repository URL. ```txt /woodpecker/src/github.com/octocat/hello-world diff --git a/docs/docs/20-usage/25-multi-pipeline.md b/docs/docs/20-usage/25-multi-pipeline.md index 81988831c..7358d7e39 100644 --- a/docs/docs/20-usage/25-multi-pipeline.md +++ b/docs/docs/20-usage/25-multi-pipeline.md @@ -90,7 +90,7 @@ The pipelines run in parallel on separate agents and share nothing. Dependencies between pipelines can be set with the `depends_on` element. A pipeline doesn't execute until all of its dependencies finished successfully. -The name for a `depends_on` entry is the filename without the path, leading dots and without the file extension `.yml`. If the project config for example uses `.woodpecker/` as path for ci files with a file named `.woodpecker/.lint.yml` the corresponding `depends_on` entry would be `lint`. +The name for a `depends_on` entry is the filename without the path, leading dots and without the file extension `.yml`. If the project config for example uses `.woodpecker/` as path for CI files with a file named `.woodpecker/.lint.yml` the corresponding `depends_on` entry would be `lint`. ```diff pipeline: diff --git a/docs/docs/20-usage/30-matrix-pipelines.md b/docs/docs/20-usage/30-matrix-pipelines.md index 41bcb9019..1c04b1d0e 100644 --- a/docs/docs/20-usage/30-matrix-pipelines.md +++ b/docs/docs/20-usage/30-matrix-pipelines.md @@ -30,7 +30,7 @@ matrix: ## Interpolation -Matrix variables are interpolated in the yaml using the `${VARIABLE}` syntax, before the yaml is parsed. This is an example yaml file before interpolating matrix parameters: +Matrix variables are interpolated in the YAML using the `${VARIABLE}` syntax, before the YAML is parsed. This is an example YAML file before interpolating matrix parameters: ```yaml matrix: diff --git a/docs/docs/20-usage/40-secrets.md b/docs/docs/20-usage/40-secrets.md index b912d7cfa..4a0dfecda 100644 --- a/docs/docs/20-usage/40-secrets.md +++ b/docs/docs/20-usage/40-secrets.md @@ -14,7 +14,7 @@ pipeline: + secrets: [ docker_username, docker_password ] ``` -Alternatively, you can get a `setting` from secrets using the `from_secret` syntax. +Alternatively, you can get a `setting` from secrets using the `from_secret` syntax. In this example, the secret named `secret_token` would be passed to the pipeline as `PLUGIN_TOKEN`. **NOTE:** the `from_secret` syntax only works with the newer `settings` block. diff --git a/docs/docs/20-usage/45-cron.md b/docs/docs/20-usage/45-cron.md index a5006d807..f607579bc 100644 --- a/docs/docs/20-usage/45-cron.md +++ b/docs/docs/20-usage/45-cron.md @@ -33,7 +33,7 @@ Read more at: [pipeline-syntax#event](./20-pipeline-syntax.md#event) Examples: `@every 5m`, `@daily`, `0 30 * * * *` ... :::info - Woodpeckers cron syntax starts with seconds instead of minutes as used by most linux cron schedulers. + Woodpeckers cron syntax starts with seconds instead of minutes as used by most linux cron schedulers. Example: "At minute 30 every hour" would be `0 30 * * * *` instead of `30 * * * *` ::: diff --git a/docs/docs/20-usage/50-environment.md b/docs/docs/20-usage/50-environment.md index 1bdd6c609..02ea741ce 100644 --- a/docs/docs/20-usage/50-environment.md +++ b/docs/docs/20-usage/50-environment.md @@ -53,14 +53,14 @@ This is the reference list of all environment variables available to your pipeli | `CI_REPO` | repository full name `/` | | `CI_REPO_OWNER` | repository owner | | `CI_REPO_NAME` | repository name | -| `CI_REPO_SCM` | repository scm (git) | +| `CI_REPO_SCM` | repository SCM (git) | | `CI_REPO_LINK` | repository link | -| `CI_REPO_REMOTE` | repository clone url | +| `CI_REPO_REMOTE` | repository clone URL | | `CI_REPO_DEFAULT_BRANCH` | repository default branch (master) | | `CI_REPO_PRIVATE` | repository is private | | `CI_REPO_TRUSTED` | repository is trusted | | | **Current Commit** | -| `CI_COMMIT_SHA` | commit sha | +| `CI_COMMIT_SHA` | commit SHA | | `CI_COMMIT_REF` | commit ref | | `CI_COMMIT_REFSPEC` | commit ref spec | | `CI_COMMIT_BRANCH` | commit branch (equals target branch for pull requests) | @@ -77,19 +77,19 @@ This is the reference list of all environment variables available to your pipeli | `CI_BUILD_NUMBER` | build number | | `CI_BUILD_PARENT` | build number of parent build | | `CI_BUILD_EVENT` | build event (push, pull_request, tag, deployment) | -| `CI_BUILD_LINK` | build link in ci | -| `CI_BUILD_DEPLOY_TARGET` | build deploy target for `deployment` events (ie production) | +| `CI_BUILD_LINK` | build link in CI | +| `CI_BUILD_DEPLOY_TARGET` | build deploy target for `deployment` events (i.e. production) | | `CI_BUILD_STATUS` | build status (success, failure) | -| `CI_BUILD_CREATED` | build created unix timestamp | -| `CI_BUILD_STARTED` | build started unix timestamp | -| `CI_BUILD_FINISHED` | build finished unix timestamp | +| `CI_BUILD_CREATED` | build created UNIX timestamp | +| `CI_BUILD_STARTED` | build started UNIX timestamp | +| `CI_BUILD_FINISHED` | build finished UNIX timestamp | | | **Current job** | | `CI_JOB_NUMBER` | job number | | `CI_JOB_STATUS` | job status (success, failure) | -| `CI_JOB_STARTED` | job started unix timestamp | -| `CI_JOB_FINISHED` | job finished unix timestamp | +| `CI_JOB_STARTED` | job started UNIX timestamp | +| `CI_JOB_FINISHED` | job finished UNIX timestamp | | | **Previous commit** | -| `CI_PREV_COMMIT_SHA` | previous commit sha | +| `CI_PREV_COMMIT_SHA` | previous commit SHA | | `CI_PREV_COMMIT_REF` | previous commit ref | | `CI_PREV_COMMIT_REFSPEC` | previous commit ref spec | | `CI_PREV_COMMIT_BRANCH` | previous commit branch | @@ -104,18 +104,18 @@ This is the reference list of all environment variables available to your pipeli | `CI_PREV_BUILD_NUMBER` | previous build number | | `CI_PREV_BUILD_PARENT` | previous build number of parent build | | `CI_PREV_BUILD_EVENT` | previous build event (push, pull_request, tag, deployment) | -| `CI_PREV_BUILD_LINK` | previous build link in ci | -| `CI_PREV_BUILD_DEPLOY_TARGET` | previous build deploy target for `deployment` events (ie production) | +| `CI_PREV_BUILD_LINK` | previous build link in CI | +| `CI_PREV_BUILD_DEPLOY_TARGET` | previous build deploy target for `deployment` events (i.e. production) | | `CI_PREV_BUILD_STATUS` | previous build status (success, failure) | -| `CI_PREV_BUILD_CREATED` | previous build created unix timestamp | -| `CI_PREV_BUILD_STARTED` | previous build started unix timestamp | -| `CI_PREV_BUILD_FINISHED` | previous build finished unix timestamp | +| `CI_PREV_BUILD_CREATED` | previous build created UNIX timestamp | +| `CI_PREV_BUILD_STARTED` | previous build started UNIX timestamp | +| `CI_PREV_BUILD_FINISHED` | previous build finished UNIX timestamp | | |   | | `CI_WORKSPACE` | Path of the workspace where source code gets cloned to | | | **System** | -| `CI_SYSTEM_NAME` | name of the ci system: `woodpecker` | -| `CI_SYSTEM_LINK` | link to ci system | -| `CI_SYSTEM_HOST` | hostname of ci server | +| `CI_SYSTEM_NAME` | name of the CI system: `woodpecker` | +| `CI_SYSTEM_LINK` | link to CI system | +| `CI_SYSTEM_HOST` | hostname of CI server | | `CI_SYSTEM_VERSION` | version of the server | | | **Internal** - Please don't use! | | `CI_SCRIPT` | Internal script path. Used to call pipeline step commands. | @@ -178,7 +178,7 @@ pipeline: Woodpecker also emulates bash string operations. This gives us the ability to manipulate the strings prior to substitution. Example use cases might include substring and stripping prefix or suffix values. -| OPERATION | DESC | +| OPERATION | DESCRIPTION | | ------------------ | ------------------------------------------------ | | `${param}` | parameter substitution | | `${param,}` | parameter substitution with lowercase first char |