diff --git a/content/cicdworkflows-enhanced/index.html b/content/cicdworkflows-enhanced/index.html index 121f87a..a2e4dff 100644 --- a/content/cicdworkflows-enhanced/index.html +++ b/content/cicdworkflows-enhanced/index.html @@ -241,7 +241,7 @@

Enhanced CICD workflows

-
+

Why should I use this?

-

As a codebase grows, it becomes more likely you will end up with a number of links in your documentation. These links can over time stop working - and often you won’t know till a user flags your links or broken.

-

This gh-action lets you stay on top of broken links, by actively scanning for them.

+

Validation is not a fixed term, and it is strongly recommended to make yourself aware of the work of the R Validation Hub (https://www.pharmar.org/), including the regulatory repo project.

+

When using an R package, it is important to know that what the documentation claims the package does is tested, and these tests pass on the environment you will be using. This gh-action generates a generic report, that takes the documentation and links it to the unit tests, and records how the the tests performed against a specific R environment.

+

The aim here is to who in a pan-company way to document the relationship between documentation and tests. Before using internally, you would need to 1) confirm the documentation is well written, 2) the unit tests are sufficient to test that documentation and 3) you are assessing against the actual environments you use internally.

How do I set it up?

-

Below is an example of using this gh-action whenever someone tries to make PR into your main or devel branch.

+

Below is an example of using this gh-action when a release is made.

---
-name: Docs πŸ“š
+name: R Package Validation report
 
-on:
-  push:
-    branches:
-      - main
-      - devel
-  pull_request:
-    branches:
-      - main
-      - devel
-
-jobs:
-  links:
-    name: Links
-    uses: pharmaverse/admiralci/.github/workflows/links.yml@main
-    if: github.event_name == 'pull_request'
-
-
-

The deets

-

This gh-action uses lychee. If you need to prevent false positive deadlinks stopping the process, you can use a .lycheeignore file. There is an example of this file from admiral here.

+on: # Run this action when a release is published + release: + types: [published] + +jobs: + r-pkg-validation: + name: Create report πŸ“ƒ + runs-on: ubuntu-latest + container: + image: rocker/verse:4.1.1 + # Set Github token permissions + env: + GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }} + permissions: + contents: write + packages: write + deployments: write + steps: + - name: Checkout repo πŸ›Ž + uses: actions/checkout@v3 + + - name: Build report πŸ— + id: validation + uses: insightsengineering/thevalidatoR@main + # see parameters above for custom templates and other formats + + # Upload the validation report to the release + - name: Upload report to release πŸ”Ό + if: success() + uses: svenstaro/upload-release-action@v2 + with: + file: ${{ steps.validation.outputs.report_output_filename }} + asset_name: ${{ steps.validation.outputs.report_output_filename }} + repo_token: ${{ secrets.GITHUB_TOKEN }} + tag: ${{ github.ref }} + overwrite: false
diff --git a/content/cicdworkflows-minimum/index.html b/content/cicdworkflows-minimum/index.html index ef9ed94..3616a8b 100644 --- a/content/cicdworkflows-minimum/index.html +++ b/content/cicdworkflows-minimum/index.html @@ -245,7 +245,7 @@

Minimum CICD workflows

-
+ -
+ -
+
-
+

diff --git a/index.html b/index.html index 3104f4b..9462e83 100644 --- a/index.html +++ b/index.html @@ -282,7 +282,7 @@

Minimum CICD

-
+ -
+ -
+

@@ -393,7 +393,7 @@

-
+

@@ -441,7 +441,7 @@

Enhanced CICD

-
+

diff --git a/meetings/index.html b/meetings/index.html index 52d772c..be619e0 100644 --- a/meetings/index.html +++ b/meetings/index.html @@ -188,7 +188,7 @@

Meetings

-
+
@@ -213,7 +213,7 @@

-
+
diff --git a/post/index.html b/post/index.html index c374b86..f208f4b 100644 --- a/post/index.html +++ b/post/index.html @@ -187,7 +187,7 @@

Posts

-
+
@@ -212,7 +212,7 @@

-
+
diff --git a/search.json b/search.json index daf1ab9..9d51bd7 100644 --- a/search.json +++ b/search.json @@ -39,21 +39,14 @@ "href": "content/cicdworkflows-enhanced/posts/validate/validate.html#why-should-i-use-this", "title": "theValidator", "section": "Why should I use this?", - "text": "Why should I use this?\nAs a codebase grows, it becomes more likely you will end up with a number of links in your documentation. These links can over time stop working - and often you won’t know till a user flags your links or broken.\nThis gh-action lets you stay on top of broken links, by actively scanning for them." + "text": "Why should I use this?\nValidation is not a fixed term, and it is strongly recommended to make yourself aware of the work of the R Validation Hub (https://www.pharmar.org/), including the regulatory repo project.\nWhen using an R package, it is important to know that what the documentation claims the package does is tested, and these tests pass on the environment you will be using. This gh-action generates a generic report, that takes the documentation and links it to the unit tests, and records how the the tests performed against a specific R environment.\nThe aim here is to who in a pan-company way to document the relationship between documentation and tests. Before using internally, you would need to 1) confirm the documentation is well written, 2) the unit tests are sufficient to test that documentation and 3) you are assessing against the actual environments you use internally." }, { "objectID": "content/cicdworkflows-enhanced/posts/validate/validate.html#how-do-i-set-it-up", "href": "content/cicdworkflows-enhanced/posts/validate/validate.html#how-do-i-set-it-up", "title": "theValidator", "section": "How do I set it up?", - "text": "How do I set it up?\nBelow is an example of using this gh-action whenever someone tries to make PR into your main or devel branch.\n---\nname: Docs πŸ“š\n\non:\n push:\n branches:\n - main\n - devel\n pull_request:\n branches:\n - main\n - devel\n\njobs:\n links:\n name: Links\n uses: pharmaverse/admiralci/.github/workflows/links.yml@main\n if: github.event_name == 'pull_request'" - }, - { - "objectID": "content/cicdworkflows-enhanced/posts/validate/validate.html#the-deets", - "href": "content/cicdworkflows-enhanced/posts/validate/validate.html#the-deets", - "title": "theValidator", - "section": "The deets", - "text": "The deets\nThis gh-action uses lychee. If you need to prevent false positive deadlinks stopping the process, you can use a .lycheeignore file. There is an example of this file from admiral here." + "text": "How do I set it up?\nBelow is an example of using this gh-action when a release is made.\n---\nname: R Package Validation report\n\non: # Run this action when a release is published\n release:\n types: [published]\n\njobs:\n r-pkg-validation:\n name: Create report πŸ“ƒ\n runs-on: ubuntu-latest\n container:\n image: rocker/verse:4.1.1\n # Set Github token permissions\n env:\n GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }}\n permissions:\n contents: write\n packages: write\n deployments: write\n steps:\n - name: Checkout repo πŸ›Ž\n uses: actions/checkout@v3\n\n - name: Build report πŸ—\n id: validation\n uses: insightsengineering/thevalidatoR@main\n # see parameters above for custom templates and other formats\n\n # Upload the validation report to the release\n - name: Upload report to release πŸ”Ό\n if: success()\n uses: svenstaro/upload-release-action@v2\n with:\n file: ${{ steps.validation.outputs.report_output_filename }}\n asset_name: ${{ steps.validation.outputs.report_output_filename }}\n repo_token: ${{ secrets.GITHUB_TOKEN }}\n tag: ${{ github.ref }}\n overwrite: false" }, { "objectID": "content/cicdworkflows-minimum/posts/code-coverage.html", diff --git a/sitemap.xml b/sitemap.xml index 4aa6c52..fe4791f 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -2,70 +2,70 @@ https://phuse-org.github.io/devops/content/cicdworkflows-recommend/posts/check-links/check-links.html - 2023-12-29T08:55:27.306Z + 2023-12-29T09:11:53.464Z https://phuse-org.github.io/devops/content/cicdworkflows-enhanced/posts/validate/validate.html - 2023-12-29T08:55:26.510Z + 2023-12-29T09:11:52.696Z https://phuse-org.github.io/devops/content/cicdworkflows-minimum/posts/code-coverage.html - 2023-12-29T08:55:25.726Z + 2023-12-29T09:11:51.888Z https://phuse-org.github.io/devops/content/cicdworkflows-minimum/posts/pkgdown.html - 2023-12-29T08:55:24.706Z + 2023-12-29T09:11:50.312Z https://phuse-org.github.io/devops/contact.html - 2023-12-29T08:55:23.622Z + 2023-12-29T09:11:49.108Z https://phuse-org.github.io/devops/post/posts/gh-actions.html - 2023-12-29T08:55:22.586Z + 2023-12-29T09:11:48.068Z https://phuse-org.github.io/devops/post/index.html - 2023-12-29T08:55:22.070Z + 2023-12-29T09:11:47.568Z https://phuse-org.github.io/devops/meetings/minutes/2023-06-23.html - 2023-12-29T08:55:21.414Z + 2023-12-29T09:11:46.948Z https://phuse-org.github.io/devops/meetings/index.html - 2023-12-29T08:55:20.538Z + 2023-12-29T09:11:46.104Z https://phuse-org.github.io/devops/meetings/minutes/2023-08-11.html - 2023-12-29T08:55:21.110Z + 2023-12-29T09:11:46.656Z https://phuse-org.github.io/devops/about.html - 2023-12-29T08:55:21.718Z + 2023-12-29T09:11:47.224Z https://phuse-org.github.io/devops/post/posts/external-resources.html - 2023-12-29T08:55:22.330Z + 2023-12-29T09:11:47.816Z https://phuse-org.github.io/devops/index.html - 2023-12-29T08:55:23.386Z + 2023-12-29T09:11:48.868Z https://phuse-org.github.io/devops/content/cicdworkflows-minimum/index.html - 2023-12-29T08:55:24.078Z + 2023-12-29T09:11:49.588Z https://phuse-org.github.io/devops/content/cicdworkflows-minimum/posts/r-cmd-check/r-cmd-check.html - 2023-12-29T08:55:25.174Z + 2023-12-29T09:11:50.780Z https://phuse-org.github.io/devops/content/cicdworkflows-enhanced/index.html - 2023-12-29T08:55:26.066Z + 2023-12-29T09:11:52.228Z https://phuse-org.github.io/devops/content/cicdworkflows-recommend/index.html - 2023-12-29T08:55:26.838Z + 2023-12-29T09:11:53.024Z