diff options
author | Achilleas Pipinellis <axilleas@axilleas.me> | 2017-05-16 17:16:14 +0300 |
---|---|---|
committer | Achilleas Pipinellis <axilleas@axilleas.me> | 2017-05-16 17:33:52 +0300 |
commit | 0c59aa0a46cb68ec379d10aa49397b7480724023 (patch) | |
tree | 76f6276ff86459e85c2b7d0276685cb86af60119 /doc/development | |
parent | 3d44ec3f4aa7180f2226f09064abe281c6b9d7be (diff) |
Add more choices to name the branch for docs only tests
http://rubular.com/r/51mKdLm6RF
Diffstat (limited to 'doc/development')
-rw-r--r-- | doc/development/writing_documentation.md | 19 |
1 files changed, 13 insertions, 6 deletions
diff --git a/doc/development/writing_documentation.md b/doc/development/writing_documentation.md index 657a826d7ee..eac9ec2a470 100644 --- a/doc/development/writing_documentation.md +++ b/doc/development/writing_documentation.md @@ -78,14 +78,21 @@ Currently GitLab docs use Redcarpet as [markdown](../user/markdown.md) engine, b We try to treat documentation as code, thus have implemented some testing. Currently, the following tests are in place: -1. `docs:check:links`: Check that all internal (relative) links work correctly -1. `docs:check:apilint`: Check that the API docs follow some conventions +1. `docs lint`: Check that all internal (relative) links work correctly and + that all cURL examples in API docs use the full switches. If your contribution contains **only** documentation changes, you can speed up -the CI process by prepending to the name of your branch: `docs/`. For example, -a valid name would be `docs/update-api-issues` and it will run only the docs -tests. If the name is `docs-update-api-issues`, the whole test suite will run -(including docs). +the CI process by following some branch naming conventions. You have three +choices: + +| Branch name | Valid example | +| ----------- | ------------- | +| Starting with `docs/` | `docs/update-api-issues` | +| Starting with `docs-` | `docs-update-api-issues` | +| Ending in `-docs` | `123-update-api-issues-docs` | + +If your branch name matches any of the above, it will run only the docs +tests. If it doesn't, the whole test suite will run (including docs). --- |