Restore Documenter gh-pages deployment permissions across 16 repositories
Nobody has claimed this yet.
- Dominant language
- Julia
- Stars
- 6
- Forks
- 5
- Avg merge
- 2d 1h
- Merged PRs (30d)
- 8
Description
Summary
Sixteen current default-branch documentation checks complete Documenter's check/render pipeline and then fail only while publishing gh-pages. Eleven repositories fail SSH authentication with Permission denied (publickey); five fail HTTPS pushes with HTTP 403.
These are repository credential/permission failures, not documentation build failures. Changing package source or weakening Documenter checks would not fix them.
SSH deploy-key failures
The jobs below reach CheckDocument/RenderDocument, enter deploydocs, and fail while fetching or pushing the SSH remote:
- CatalystNetworkAnalysis.jl: https://github.com/SciML/CatalystNetworkAnalysis.jl/actions/runs/32517916308/job/96883595628
- ColPrac: https://github.com/SciML/ColPrac/actions/runs/27902030478/job/82563928923
- DiffEqParamEstim.jl: https://github.com/SciML/DiffEqParamEstim.jl/actions/runs/33443510591/job/99665407218
- Evolutionary.jl: https://github.com/SciML/Evolutionary.jl/actions/runs/33287252786/job/99192485246
- FiniteVolumeMethod.jl: https://github.com/SciML/FiniteVolumeMethod.jl/actions/runs/32949884685/job/98118690682
- FiniteVolumeMethod1D.jl: https://github.com/SciML/FiniteVolumeMethod1D.jl/actions/runs/32118961674/job/95654765685
- MathML.jl: https://github.com/SciML/MathML.jl/actions/runs/32950047920/job/98119201247
- MethodOfLines.jl: https://github.com/SciML/MethodOfLines.jl/actions/runs/33638272544/job/100274545190
- NBodySimulator.jl: https://github.com/SciML/NBodySimulator.jl/actions/runs/33287247080/job/99192470427
- SciMLExpectations.jl: https://github.com/SciML/SciMLExpectations.jl/actions/runs/33001852147/job/98285460494
- SciMLWorkshop.jl: https://github.com/SciML/SciMLWorkshop.jl/actions/runs/32931901658/job/98065612769
For these repositories, rotate/re-register the DOCUMENTER_KEY pair and ensure the public deploy key has write access. CatalystNetworkAnalysis.jl already has the repository-specific diagnosis at https://github.com/SciML/CatalystNetworkAnalysis.jl/issues/75.
HTTPS token-permission failures
These jobs also build and render successfully, then git push ... HEAD:gh-pages receives HTTP 403:
- DataCollocations.jl: https://github.com/SciML/DataCollocations.jl/actions/runs/32949653799/job/98117969126
- LightweightStats.jl: https://github.com/SciML/LightweightStats.jl/actions/runs/30374831960/job/90327692919
- PDEBase.jl: https://github.com/SciML/PDEBase.jl/actions/runs/33313238060/job/99261924998
- SparseColumnPivotedQR.jl: https://github.com/SciML/SparseColumnPivotedQR.jl/actions/runs/33253045320/job/99101917832
- SparseMatrixIdentification.jl: https://github.com/SciML/SparseMatrixIdentification.jl/actions/runs/32950623494/job/98149999000
For these repositories, grant Actions GITHUB_TOKEN write access to repository contents, or configure a valid Documenter deploy key consistently with the rest of the organization.
After correcting the repository settings, rerun the linked workflow runs to verify publication and clear the red default-branch checks.
Investigated by an AI agent using Codex CLI 0.151.0 (model: gpt-5.6-sol; session: local session ID 01a0598f-11b9-72d1-91d9-b2fbb186557d).
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the listed workflow runs and each repository’s Documenter deploydocs configuration. Check the DOCUMENTER_KEY deploy-key access and Actions GITHUB_TOKEN contents permissions for the affected repositories, then rerun the linked workflows. Done means all documentation jobs publish to gh-pages and the default-branch checks pass.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- github, github-actions, julia
- Domain
- ci-cd, devops, documentation
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100