Skip to content

Commit 2de8b1c

Browse files
committed
Merge branch 'main' into feat-system-wide-singularity-update
2 parents 92dbd02 + 6d35308 commit 2de8b1c

File tree

371 files changed

+8288
-2493
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

371 files changed

+8288
-2493
lines changed

.github/ISSUE_TEMPLATE/article_request.yml

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,10 @@ body:
1010
id: description
1111
attributes:
1212
label: What would you like to see added?
13-
description: Please tell us about what article or section you think is missing. Please include images and links as appropriate, and tell us where you think the new content would best fit.
13+
description:
14+
Please tell us about what article or section you think is missing.
15+
Please include images and links as appropriate, and tell us where you
16+
think the new content would best fit.
1417
placeholder: Tell us what you would like to see!
1518
validations:
1619
required: true

.github/ISSUE_TEMPLATE/bug_report.yml

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,9 @@ body:
1010
id: what-happened
1111
attributes:
1212
label: What happened?
13-
description: Please describe what happened. Screenshots and URLs of affected parts are welcome.
13+
description:
14+
Please describe what happened. Screenshots and URLs of affected parts
15+
are welcome.
1416
placeholder: Tell us what you see!
1517
validations:
1618
required: true

.github/pull_request_template.md

Lines changed: 33 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,43 @@
11
# Pull Request
22

3-
<!-- PLEASE READ THE COMMENTS BELOW -->
4-
5-
## Overview
6-
7-
<!-- Briefly summarize the proposed changes -->
3+
## Intent
4+
<!-- Describe the intent of the changes. -->
85

96
## Proposed Changes
7+
<!-- Provide specific details of what is changing. -->
108

11-
<!-- Provide specific details of what is changing -->
9+
### Changes to Section Headers
10+
<!-- Write down which headers have changed.
11+
old-header -> new-header
12+
-->
1213

13-
## Related Issues
14+
### Changes to Page URLs
15+
<!-- Write down which pages have changed.
16+
old/page.md -> new/page.md
17+
-->
1418

15-
<!--
16-
Examples:
19+
## Related or Fixed Issues
20+
<!-- Examples:
1721
Fixes #123
1822
Related to #101
1923
-->
24+
25+
## Accessibility Checklist
26+
27+
I have ensured all of the following for new or changed content:
28+
29+
- [ ] all images have appropriate alt text. [Guidelines](https://www.wcag.com/blog/good-alt-text-bad-alt-text-making-your-content-perceivable/)
30+
- [ ] all images with text have sufficient contrast ratio. [Checker](https://webaim.org/resources/contrastchecker/)
31+
- [ ] all image text is transcribed or described in body text.
32+
- [ ] all technical terms, jargon, and abbreviations are introduced before they are used.
33+
34+
## Style Checklist
35+
36+
I have done all of the following:
37+
38+
- [ ] searched for other relevant pages and crosslinked from my content to them.
39+
- [ ] searched for other relevant pages and crosslinked from them to my content.
40+
- [ ] added redirects in `mkdocs.yml` for any moved headers or pages.
41+
- [ ] defined new technical terms, jargon, and abbreviations in the glossary.
42+
- [ ] searched for existing technical terms, jargon, and abbreviations in the glossary and added crosslinks to them.
43+
- [ ] properly formatted and introduced key branding terms. [List here](https://docs.rc.uab.edu/contributing/contributor_guide#terminology).
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# builds mkdocs, reusable by other checks
2+
3+
name: Build Docs Pages
4+
description: Build Docs Pages for mkdocs workflows.
5+
6+
runs:
7+
using: composite
8+
steps:
9+
- uses: conda-incubator/setup-miniconda@835234971496cad1653abb28a638a281cf32541f # 3.2.0
10+
with:
11+
environment-file: build_env.yml
12+
activate-environment: mkdocs
13+
miniforge-version: latest
14+
15+
- name: Build Pages # this is both a build and check step
16+
run: mkdocs build --strict
17+
shell: bash -l {0} # must have -l because conda requires login shell to function in subsequent steps

.github/workflows/check_docs.yml

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
# checks for mkdocs specific issues
2+
3+
name: docs
4+
5+
on: # yamllint disable-line rule:truthy
6+
pull_request:
7+
branches:
8+
- main
9+
paths:
10+
- "build_env.yml"
11+
- "mkdocs.yml"
12+
- "build_scripts/**"
13+
- "docs/**"
14+
workflow_dispatch:
15+
16+
jobs:
17+
check_markdown:
18+
uses: "./.github/workflows/reusable_check_markdown.yml"
19+
with:
20+
globs: "docs/**/*.md"
21+
check_docs:
22+
needs: check_markdown
23+
runs-on: ubuntu-latest
24+
permissions:
25+
contents: read
26+
steps:
27+
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # 4.2.2
28+
with:
29+
fetch-depth: 0 # mkdocs-git-revision-date-localized-plugin
30+
- uses: "./.github/shared/build_docs_pages/"

.github/workflows/check_python.yml

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# checks python files for python linting and formatting issues
2+
3+
name: python
4+
5+
on: # yamllint disable-line rule:truthy
6+
push:
7+
branches:
8+
- main
9+
paths:
10+
- "**.py"
11+
pull_request:
12+
branches:
13+
- main
14+
paths:
15+
- "**.py"
16+
workflow_dispatch:
17+
18+
jobs:
19+
check_python:
20+
runs-on: ubuntu-latest
21+
permissions:
22+
contents: read
23+
strategy:
24+
matrix:
25+
args: ["check", "format --check --diff"]
26+
steps:
27+
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # 4.2.2
28+
- uses: astral-sh/ruff-action@eaf0ecdd668ceea36159ff9d91882c9795d89b49 # 3.4.0
29+
with:
30+
args: ${{ matrix.args }}
31+
version: 0.12.0

.github/workflows/check_yaml.yml

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# checks yaml for yaml-specific linting and formatting issues
2+
3+
name: yaml
4+
5+
on: # yamllint disable-line rule:truthy
6+
push:
7+
branches:
8+
- main
9+
paths:
10+
- "**.yml"
11+
- "**.yaml"
12+
pull_request:
13+
branches:
14+
- main
15+
paths:
16+
- "**.yml"
17+
- "**.yaml"
18+
workflow_dispatch:
19+
20+
jobs:
21+
check_yaml:
22+
runs-on: ubuntu-latest
23+
permissions:
24+
contents: read
25+
steps:
26+
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # 4.2.2
27+
- uses: karancode/yamllint-github-action@4052d365f09b8d34eb552c363d1141fd60e2aeb2 # 3.0.0
28+
with:
29+
yamllint_config_filepath: ".yamllint.yaml"
30+
yamllint_strict: true
31+
yamllint_comment: true

.github/workflows/ci.yml

Lines changed: 0 additions & 31 deletions
This file was deleted.

.github/workflows/deploy_docs.yml

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
# deploys documentation to gh-pages
2+
3+
name: docs
4+
5+
on: # yamllint disable-line rule:truthy
6+
push:
7+
branches:
8+
- main
9+
paths:
10+
- "build_env.yml"
11+
- "mkdocs.yml"
12+
- "build_scripts/**"
13+
- "docs/**"
14+
workflow_dispatch:
15+
16+
jobs:
17+
check_markdown:
18+
uses: "./.github/workflows/reusable_check_markdown.yml"
19+
with:
20+
globs: "docs/**/*.md"
21+
deploy_docs:
22+
needs: check_markdown
23+
environment:
24+
name: github-pages
25+
url: ${{ steps.deployment.outputs.page_url }}
26+
runs-on: ubuntu-latest
27+
permissions:
28+
contents: read
29+
pages: write
30+
id-token: write
31+
steps:
32+
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # 4.2.2
33+
with:
34+
fetch-depth: 0 # mkdocs-git-revision-date-localized-plugin
35+
- uses: "./.github/shared/build_docs_pages/"
36+
- uses: actions/configure-pages@983d7736d9b0ae728b81ab479565c72886d7745b # 5.0.0
37+
- uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa # 3.0.1
38+
with:
39+
path: "./site"
40+
- uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e # 4.0.5
Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
# checks markdown files for markdown specific linting and formatting issues
2+
# reusable by other checks
3+
4+
name: markdown
5+
6+
on: # yamllint disable-line rule:truthy
7+
push:
8+
branches:
9+
- main
10+
paths:
11+
- "**.md"
12+
- "!docs/**" # covered by check_docs.yml
13+
pull_request:
14+
branches:
15+
- main
16+
paths:
17+
- "**.md"
18+
- "!docs/**" # covered by check_docs.yml
19+
workflow_dispatch:
20+
workflow_call:
21+
inputs:
22+
globs:
23+
type: string
24+
25+
jobs:
26+
check_markdown:
27+
runs-on: ubuntu-latest
28+
permissions:
29+
contents: read
30+
steps:
31+
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # 4.2.2
32+
- name: Configure Globs
33+
id: globs
34+
run: |
35+
if [ -n "${{ inputs.globs }}" ]; then
36+
GLOBS_STRING="${{ inputs.globs }}"
37+
else
38+
GLOBS_STRING='**/*.md !docs/**/*.md'
39+
fi
40+
41+
IFS=' ' read -r -a GLOBS_ARRAY <<< "$GLOBS_STRING"
42+
NEWLINE_DELIMITED_GLOBS=""
43+
for glob in "${GLOBS_ARRAY[@]}"; do
44+
if [ -n "$NEWLINE_DELIMITED_GLOBS" ]; then
45+
NEWLINE_DELIMITED_GLOBS+=$'\n'
46+
fi
47+
NEWLINE_DELIMITED_GLOBS+="$glob"
48+
done
49+
50+
echo "globs<<EOF" >> "$GITHUB_OUTPUT"
51+
echo "$NEWLINE_DELIMITED_GLOBS" >> "$GITHUB_OUTPUT"
52+
echo "EOF" >> "$GITHUB_OUTPUT"
53+
- uses: DavidAnson/markdownlint-cli2-action@992badcdf24e3b8eb7e87ff9287fe931bcb00c6e # 20.0.0
54+
with:
55+
config: ".markdownlint-cli2.jsonc"
56+
globs: "${{ steps.globs.outputs.globs }}"

0 commit comments

Comments
 (0)