Skip to content

GitHub Pages publishing docs still show actions/checkout@v4, triggering Node 20 deprecation warnings #14796

Description

@connortwiegand

I have:

  • searched the issue tracker for similar issues
  • installed the latest version of Quarto CLI
  • formatted my issue following the Bug Reports guide

Bug description

The GitHub Pages publishing guide currently pins actions/checkout@v4 in all three of its workflow examples (Publish Action, Jupyter+venv, Knitr+renv). Following these docs as written now surfaces GitHub's Node 20 deprecation warning, since actions/checkout@v4 runs on the Node 20 runtime that GitHub retired on Actions runners.

Note that quarto-cli's own CI moved off actions/checkout@v4 in #14199 (v4 → v6, along with actions/cache, upload-artifact, download-artifact, and setup-node), citing this same Node 20 deprecation.

Already fixed is the quarto-actions/publish README; this already carries a note that the action is compatible with actions/checkout@v6+, with @v5 as a fallback pin (referencing quarto-actions#133) — but that's a repo README, not a page on quarto.org, so it's easy to miss.

Ask:

Update the three actions/checkout@v4 references on the GitHub Pages publishing page to @v5 or @v6 so the copy-pasteable examples don't hand new users a deprecation warning.

Thanks Quarto Team!!

Steps to reproduce

Use the copy/pasted publish workflow from Quarto's GH pages publishing docs:

on:
  workflow_dispatch:
  push:
    branches: main

name: Quarto Publish

jobs:
  build-deploy:
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - name: Check out repository
        uses: actions/checkout@v4

      - name: Set up Quarto
        uses: quarto-dev/quarto-actions/setup@v2

      - name: Render and Publish
        uses: quarto-dev/quarto-actions/publish@v2
        with:
          target: gh-pages
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Use this to publish a quarto website and you get the Node20 warning.

Actual behavior

Warning surfaced.

Expected behavior

No warning surfaced.

Your environment

  • Linux Mint 22.1 with Cinnamon
  • Ubuntu 24.04 Noble pakcage base
  • Positron IDE

Quarto check output

$ quarto check
Quarto 1.10.18
[✓] Checking environment information...
      Quarto cache location: /home/cwiegand/.cache/quarto
[✓] Checking versions of quarto binary dependencies...
      Pandoc version 3.10.0: OK
      Dart Sass version 1.101.0: OK
      Deno version 2.7.14: OK
      Typst version 0.15.1: OK
[✓] Checking versions of quarto dependencies......OK
[✓] Checking Quarto installation......OK
      Version: 1.10.18
      Path: /opt/quarto/bin

[✓] Checking tools....................OK
      TinyTeX: (external install)
      Chrome Headless Shell: (not installed)
      VeraPDF: (not installed)

[✓] Checking LaTeX....................OK
      Using: TinyTex
      Path: /home/cwiegand/.TinyTeX/bin/x86_64-linux
      Version: 2026

[✓] Checking Chrome Headless....................OK
      Chrome:  (not detected)

[✓] Checking basic markdown render....OK

[✓] Checking R installation...........OK
      Version: 4.6.1
      Path: /usr/lib/R
      LibPaths:
        - /usr/local/lib/R/site-library
        - /usr/lib/R/site-library
        - /usr/lib/R/library
      knitr: 1.51
      rmarkdown: 2.31

[✓] Checking Knitr engine render......OK

[✓] Checking Python 3 installation....OK
      Version: 3.12.3
      Path: /usr/bin/python3
      Jupyter: (None)

      Jupyter is not available in this Python installation.
      Install with python3 -m pip install jupyter

[✓] Checking Julia installation...

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationDoc improvements & quarto-web

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions