Help with CI Failures on JuliaDocs PR #2870

Tooling
1

Hi everyone!

I’m Aman, a B.Tech CS student at Thapar University. I’ve started contributing to the Julia ecosystem recently, specifically focusing on Documenter.jl and JuliaDocs, as I’m hoping to apply for GSoC 2026.

I recently submitted PR #2870 to add a Prettier command to the makefile. I’ve been working through the CI failures - I found and fixed a broken link in the CHANGELOG that was hitting the Linkchecker but still seeing some failure ss below

image
image915×487 29.2 KB

I’m trying to figure out if these failures are:

  1. Upstream: Known flakiness with the nightly Julia version.
  2. Local: An issue with how I structured the make command or anything else

I’d really appreciate any advice on how to debug the nightly build logs for this project. @mortenpi and @fredrikekre

Thanks for all the work you do on these docs

2

Hi and welcome to the Julia Discourse! :waving_hand:

Could you maybe mention which Repository that PR is on? I know you can not post links as someone new, but on the usual Repositories that came to my mind (Documenter.jl, Julia itself,…) That number does not fit. Also your screenshot shows another number than the one you wrote in your text.

edit: Ah I found it, so for completeness and other readers, it is this PR: fix: add make command to run Prettier (#2529) by AmanKashyap0807 · Pull Request #2870 · JuliaDocs/Documenter.jl · GitHub

3

Welcome, Aman!

Looking at master, I do see some CI failures there.

Here’s what you might consider doing:

  1. Pick a recent commit on master, and look at the CI failures there. As an example, you might look at Handle tilde in URLs right when generating LaTeX (#2863) · JuliaDocs/Documenter.jl@550adee · GitHub, which as of the time of writing is the tip of master. Look through the jobs that failed there.
  2. Compare the failures on master to the failures you’re seeing on your PR. If all the failures are the same, then the problem is likely not within your PR.