From 8a9b046bc113ac16ccefb0090299bc483ae84c50 Mon Sep 17 00:00:00 2001
From: Kate Isaac <41767733+kweav@users.noreply.github.com>
Date: Fri, 30 May 2025 15:44:23 -0400
Subject: [PATCH 01/17] Update description of config_automation and screenshots
---
customize-robots.Rmd | 124 +++++++++++++++++++++++++++++++------------
1 file changed, 91 insertions(+), 33 deletions(-)
diff --git a/customize-robots.Rmd b/customize-robots.Rmd
index ff78d21..14bd03a 100644
--- a/customize-robots.Rmd
+++ b/customize-robots.Rmd
@@ -6,27 +6,50 @@ output:
toc_float: true
---
-By default, all automation steps and checks will run. Based on the requirements of your course, you have the flexibility to enable or disable specific features by modifying the settings in the `config_automation.yml` file. Simply adjust the options to "yes" or "no" accordingly.
+By default, all automation steps and checks will run. Based on the requirements of your course, you have the flexibility to enable or disable specific features by modifying the settings in the `config_automation.yml` file. Simply adjust the options to "true" or "false" accordingly.
The `config_automation.yml` file looks like this:
```
+### Render preview of content with changes (Rmd's and md's are checked)
+render-preview: true
+
##### Checks run at pull request #####
# Check quiz formatting
-check-quizzes: no
+check-quizzes: false
+quiz_error_min: 0
# Check that urls in the content are not broken
-url-checker: yes
-# Render preview of content with changes (Rmd's and md's are checked)
-render-preview: yes
+url-checker: true
+url_error_min: 0
# Spell check Rmds and quizzes
-spell-check: yes
+spell-check: true
+spell_error_min: 0
+
+#### Other options
# Style any R code
-style-code: yes
+style-code: true
+# Would you like your markdown files to be checked for formatting
+markdown-linter: true
+# Would you like a readability report on your markdowns?
+readability-report: true
# Test build the docker image if any docker-relevant files have been changed
-docker-test: no
+docker-test: false
# Should URLs be tested periodically?
-url-check-periodically: yes
-...
+url-check-periodically: true
+
+##### Renderings run upon merge to main branch #####
+# Rendering each platform's content
+render-website: rmd
+render-leanpub: true
+render-coursera: true
+
+## Automate the creation of Book.txt file? yes/no
+## This is only relevant if render-leanpub is yes, otherwise it will be ignored
+make-book-txt: true
+
+# What docker image should be used for rendering?
+# The default is jhudsl/base_ottr:main
+rendering-docker-image: 'jhudsl/base_ottr:main'
```
There are three main sets of automation steps and checks run:
@@ -44,10 +67,10 @@ These actions are triggered upon a pull request being opened. They are set up in
In the `config_automation.yml` file it is set by:
```
-check-quizzes: no
+check-quizzes: false
```
-By default, it is set to `no`. But if you wish to [create quizzes on Leanpub](https://www.ottrproject.org/course_publishing.html#publishing-with-leanpub), you should set this to `yes`. This is not necessary if you only want quizzes for Coursera.
+By default, it is set to `false`. But if you wish to [create quizzes on Leanpub](https://www.ottrproject.org/course_publishing.html#publishing-with-leanpub), you should set this to `true`. This is not necessary if you only want quizzes for Coursera.
Leanpub needs a particular format for it to upload correctly. This action will look for quizzes in the `quizzes` directory and check for these items. The outcome of these quiz checks will be printed to a GitHub comment on your pull request.
### Check for broken URLs
@@ -56,31 +79,34 @@ In the `config_automation.yml` file there are two different URL checkers.
1) One that is run during pull requests. It is set by:
```
-url-checker: yes
+url-checker: true
```
GitHub Actions runs a check on all the URLs upon creating a pull request to the `main` branch.
-If it fails, you can click on the output comment on your pull request that says "Download errors here". This will give you a print out of the broken URLs it found.
+If it fails, you can click on the output comment on your pull request that says "Click here to download detailed error reports". This will download a zip file containing a list of the broken URLs it found.
-GitHub Actions runs a check on all the URLs upon creating a pull request to the `main` branch.
-If it fails, you can click on the output comment on your pull request that says "Download errors here". This will give you a print out of the broken URLs it found.
+If you don't set the additional error threshold option in the config_automation file, the check summary may still report that the URL check failed, even if 0 errors were found.
+
+```
+url_error_min: 0
+```
2) The other URL check runs on a set interval to see if any URLs referenced are no longer valid. This one is set by:
```
-url-check-periodically: yes
+url-check-periodically: true
```
-If either URL checker is failing on something that isn't really a URL or doesn't need to be checked, open the `resources/ignore-urls.txt` file and add that URL exactly as it is specified in the error print out.
+If either URL checker is failing on something that isn't really a URL or doesn't need to be checked, open the `resources/ignore-urls.txt` file and add that URL exactly as it is specified in the error print out. After committing the changes to `resources/ignore-urls.txt` on your branch, the url check status check should be successfully passed.
### Preview rendering
In the `config_automation.yml` file it is set by:
```
-render-preview: yes
+render-preview: true
```
After you open a pull request, a preview of the renders will be linked in an automatic comment on the pull request. Upon each commit these previews will re-render and edit the comment with the latest render.
-
+
These Github Actions are located in `render-preview` section of the `pull-request.yml`.
These previews do NOT incorporate any changes influenced by any changes to the Docker image if the Dockerfile is also updated in the same pull request.
@@ -90,26 +116,38 @@ These previews do NOT incorporate any changes influenced by any changes to the D
In the `config_automation.yml` file it is set by:
```
-spell-check: yes
+spell-check: true
```
Github Actions will automatically run a spell check on all Rmds and mds whenever a pull request to the `main` branch is filed.
-It will fail if there are more than 2 spelling errors and you'll need to resolve those before being able to merge your pull request. Errors will be printed out on a GitHub comment on your pull request.
+The error threshold option controls how many errors are allowed before the check will fail.
-
+```
+spell_error_min: 0
+```
+
+You'll need to resolve those before being able to merge your pull request. Errors are displayed in much the same way as PR URL check errors with a summary of how many errors are found. Click on the output comment on your pull request that says "Click here to download detailed error reports". This will download a zip file containing a list of the spelling errors it found.
-To resolve those spelling errors, click on the link with the errors on the autogenerated comment.
Some of these errors may be things that the spell check doesn't recognize for example: `ITCR` or `DaSL`.
If it's a 'word' the spell check should recognize, you'll need to add this to the dictionary.
Go to the `resources/dictionary.txt` file. Open the file and add the new 'word' to its appropriate place (the words are in alphabetical order).
After committing the changes to `resources/dictionary.txt` on your branch, the spell check status check should be successfully passed.
+The PR comment included below shows an example of a check that passed (spell check), and a check that failed (the URL check) with the option to download detailed error report(s).
+
+
+
+When all checks pass, the option to download error reports is no longer included, instead displaying a message that the URL and spell checks passed.
+
+![]
+(https://raw.githubusercontent.com/ottrproject/ottrproject.github.io/main/resources/screenshots/check_results_pass.png)
+
### Style code
In the `config_automation.yml` file it is set by:
```
-style-code: yes
+style-code: true
```
The `styler` package will style R code in all Rmds. Style changes will automatically be committed back to your branch.
@@ -117,9 +155,9 @@ The `styler` package will style R code in all Rmds. Style changes will automatic
In the config_automation.yml file it looks like:
```
-docker-test: no
+docker-test: false
```
-By default it is set to `no` which means it won't run automatically unless you change this to `yes`.
+By default it is set to `false` which means it won't run automatically unless you change this to `true`.
This is only relevant if you have [your own Docker image you are managing for your course](https://www.ottrproject.org/customize-docker.html). If changes are made to Docker-relevant files: `Dockerfile`, `install_github.R`, or `github_package_list.tsv`, this will test re-build the Docker image. If it is successfully built, then it makes sense to merge it to `main` but the Docker Image will not be pushed to `Dockerhub` automatically. [Follow these instructions to push your Docker image to Dockerhub](https://www.ottrproject.org/customize-docker.html#Testing_a_modified_Docker_image).
@@ -127,16 +165,36 @@ This is only relevant if you have [your own Docker image you are managing for yo
## Rendering actions
Upon merging changes to any `Rmd` or `assets/` folder to `main`, the course material will be automatically re-rendered.
-By default, all rendering steps will be run. But depending on the needs of your course, you can turn these on and off by going to the `config_automation.yml` file and switching options to `yes` or `no`.
+
+For rendering a website version of the course (or your website), rather than `true` or `false`, the options are `rmd`, `rmd_web`, `quarto` or `quarto_web`.
+
+ * If rendering a course with rmarkdown files, use `rmd`.
+ * If rendering a course with quarto files, use `quarto`.
+ * If rendering a website with rmarkdown files, use `rmd_web`.
+ * If rendering a website with quarto files, use `quarto_web`.
+
+```
+render-website: rmd
+```
+
+By default, all rendering steps will be run. But depending on the needs of your course, you can turn these on and off by going to the `config_automation.yml` file and switching options to `true` or `false`.
+
+```
+render-leanpub: true
+render-coursera: true
+```
+
+For publishing to Leanpub, make sure that the render Leanpub option is set to true: `render-leanpub: true`. See more details about publishing to Leanpub [here](https://www.ottrproject.org/course_publishing.html#publishing-with-leanpub).
+
+If render-leanpub is true, the `make-book-txt` option is also relevant. This option controls whether you'd like to manually specify the order of your chapters and quizzes by creating the [Book.txt file](https://leanpub.com/lfm/read#leanpub-auto-the-booktxt-file) by hand or whether you'd like this to be [automatically generated based on file and quiz numbering.](https://ottrproject.org/ottrpal/#about-the-booktxt-file). Read more about this [in the upcoming section](https://www.ottrproject.org/examples.html#Setting_up_quizzes).
+
+By default, `make-book-txt: true` will use the numbering in the names of the documents for chapters and quizzes to order them, but if you'd like to specify the order for the chapters and quizzes to be different on Leanpub, then set this to `make-book-txt: false`, so as not to override the book.txt file that you would make manually.
```
-render-bookdown: yes
-render-leanpub: yes
-render-coursera: yes
+make-book-txt: true
```
-For publishing to Leanpub, make sure that the render Leanpub option is set to yes: `render-leanpub: yes`. See more details about publishing to Leanpub [here](https://www.ottrproject.org/course_publishing.html#publishing-with-leanpub).
-For publishing to Coursera, make sure render Coursera option is set to yes: `render-coursera: yes`. See more details about publishing to Coursera [here](https://www.ottrproject.org/course_publishing.html#publishing-with-coursera).
+For publishing to Coursera, make sure render Coursera option is set to true: `render-coursera: true`. See more details about publishing to Coursera [here](https://www.ottrproject.org/course_publishing.html#publishing-with-coursera).
From 52d7efac298a0602d3e281619c60bcbf441948fa Mon Sep 17 00:00:00 2001
From: Kate Isaac <41767733+kweav@users.noreply.github.com>
Date: Fri, 30 May 2025 15:47:10 -0400
Subject: [PATCH 02/17] point to current branch for images
---
customize-robots.Rmd | 10 +++++-----
resources/screenshots/check_results.png | Bin 0 -> 124154 bytes
resources/screenshots/check_results_pass.png | Bin 0 -> 111219 bytes
resources/screenshots/preview_comment.png | Bin 0 -> 130496 bytes
4 files changed, 5 insertions(+), 5 deletions(-)
create mode 100644 resources/screenshots/check_results.png
create mode 100644 resources/screenshots/check_results_pass.png
create mode 100644 resources/screenshots/preview_comment.png
diff --git a/customize-robots.Rmd b/customize-robots.Rmd
index 14bd03a..bbc8c8b 100644
--- a/customize-robots.Rmd
+++ b/customize-robots.Rmd
@@ -106,7 +106,7 @@ render-preview: true
```
After you open a pull request, a preview of the renders will be linked in an automatic comment on the pull request. Upon each commit these previews will re-render and edit the comment with the latest render.
-
+
These Github Actions are located in `render-preview` section of the `pull-request.yml`.
These previews do NOT incorporate any changes influenced by any changes to the Docker image if the Dockerfile is also updated in the same pull request.
@@ -136,12 +136,12 @@ After committing the changes to `resources/dictionary.txt` on your branch, the s
The PR comment included below shows an example of a check that passed (spell check), and a check that failed (the URL check) with the option to download detailed error report(s).
-
+
When all checks pass, the option to download error reports is no longer included, instead displaying a message that the URL and spell checks passed.
![]
-(https://raw.githubusercontent.com/ottrproject/ottrproject.github.io/main/resources/screenshots/check_results_pass.png)
+(https://raw.githubusercontent.com/ottrproject/ottrproject.github.io/kweav-actionsDocsUpdate/resources/screenshots/check_results_pass.png)
### Style code
@@ -166,8 +166,8 @@ This is only relevant if you have [your own Docker image you are managing for yo
Upon merging changes to any `Rmd` or `assets/` folder to `main`, the course material will be automatically re-rendered.
-For rendering a website version of the course (or your website), rather than `true` or `false`, the options are `rmd`, `rmd_web`, `quarto` or `quarto_web`.
-
+For rendering a website version of the course (or your website), rather than `true` or `false`, the options are `rmd`, `rmd_web`, `quarto` or `quarto_web`.
+
* If rendering a course with rmarkdown files, use `rmd`.
* If rendering a course with quarto files, use `quarto`.
* If rendering a website with rmarkdown files, use `rmd_web`.
diff --git a/resources/screenshots/check_results.png b/resources/screenshots/check_results.png
new file mode 100644
index 0000000000000000000000000000000000000000..7855aacf2f7db576c238e994b3c408589bef8939
GIT binary patch
literal 124154
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