Skip to content

Commit

Permalink
complete README
Browse files Browse the repository at this point in the history
  • Loading branch information
3nids committed Jan 10, 2020
1 parent c7b1e5d commit c91a133
Showing 1 changed file with 4 additions and 6 deletions.
10 changes: 4 additions & 6 deletions .github/workflows/pr_to_doc_issue.md
Expand Up @@ -6,17 +6,15 @@
4) Merge it

Then
* an issue is automatically created in the QGIS-Documentation repository
* in the PR, a message pings the author to tell him he should take care of the documentation issue
* a message will be added to PR to ping the author about her/his responsibility to handle the documentation issue
* an issue is automatically created in the QGIS-Documentation repository when the PR gets merged

Example:
* Dummy PR: https://github.com/qgis/QGIS/pull/33627
* Auto created issue: https://github.com/qgis/QGIS-Documentation/issues/4744
* Dummy PR: https://github.com/qgis/QGIS/pull/33525
* Auto created issue: https://github.com/qgis/QGIS-Documentation/issues/4763

## How it works

* A Github [workflow]( https://github.com/qgis/QGIS/blob/master/.github/workflows/pr_to_doc_issue.yml) takes care of creating the issue and commenting.
* To make it works on jobs triggered from forks (almost all PRs actually), the Github token has to be manually given. Since it cannot be written in clear, an [action](https://github.com/opengisch/clear-token) obfuscates its using xor encryption.
* The labels on QGIS-Documentation are deduced from the PR milestone (e.g. 3.10.2 => 3.10). To label issues, push access is required. Due to security reasons (the token appears in clear), qgis-bot has no specific rights. Labels are created using a [workflow](https://github.com/qgis/QGIS-Documentation/blob/master/.github/workflows/auto-label.yml).


0 comments on commit c91a133

Please sign in to comment.