Skip to content

Comments

Various CI and doc refactors#4928

Merged
cobaltt7 merged 11 commits intopsf:mainfrom
cobaltt7:ci-refactors
Jan 16, 2026
Merged

Various CI and doc refactors#4928
cobaltt7 merged 11 commits intopsf:mainfrom
cobaltt7:ci-refactors

Conversation

@cobaltt7
Copy link
Collaborator

@cobaltt7 cobaltt7 commented Dec 29, 2025

Description

Various unrelated refactors, most of which are too small for their own PR

Since most changes are largely unrelated, it may be easier to review this PR commit-by-commit, so I made sure to keep each change contained to a single commit and I've listed them here:

  • 0457459: Rename workflows, jobs, and steps for consistency, clarity, and correctness
  • 465f2b5: Set up dependency groups in pyproject.toml
    • See Pin Hatch to hopefully fix Docker builds #4878 (comment)
    • Use them most places (some places are migrated in future commits, they're used everywhere by the end of the PR)
    • Also bumps some action runner versions
    • And updates dependabot/pre-commit config to check for more updates
    • Remove second unnecessary mypy config now that the default minimum version is 3.10
  • 2399c5d: Add and improve paths matchers on action triggers
  • 00fb065: Split up build workflow jobs into build and publish
  • 5ff2a0f: Correct wrong/outdated information in release & build docs
  • 5b1b02e: Don't wrap prose in issue/PR templates
    • GitHub issue comments preserve all newlines
    • GitHub releases do as well, so this should maybe be expanded to include CHANGES.md too, but that would be a more intrusive change
  • d2e7a67: Manually reformat places that don't get autoformatted
    • Most notably:
      • vim files (and Python heredocs)
      • Sphinx attestations
      • pyproject.toml
    • I used 4-space indents to be consistent with Black
    • Files formatted with Prettier are currently defaulting to 2-space indents, but I left that alone for now
  • 01a1e4c: Modfiy codeblock languages
    • Standardize /py(thon)?(3)?/ to python
    • Only use console when the ps prompt is included, and don't put comments where output should be
    • Add a few other missing languages
  • d351d1b: Minor misc docs rewordings (and add myself to AUTHORS.md)
  • 5977512: Run docker builds in parallel using native builders
    • Cuts build times from ~45 to ~6 minutes
  • 3d7b406: Refactor diff-shades workflow
    • It still uses the workflow_run trigger unfortunately (see Lingering CI/CD pins, add cooldowns, remove template injections #4906); there's no way to comment on the PR without it
      • Having said that, I think the usage of this is "safe"
      • To my understanding, the worst someone could do is modify the comment to whatever they wanted
      • I don't think it'd be worth it to remove the comment functionality just to satisfy the linter
      • Also, a maintainer has to manually approve CI on PRs unless they've contributed before, so it'd be a fair amount of effort for someone to troll
    • Reword PR comment to be clearer and more detailed (example: cobaltt7-patch-1 cobaltt7/black#7 (comment))
    • Work around Prettier format issues
    • Update docs appropriately

all CI changes were tested as best I could

Checklist - did you ...

  • [-] Implement any code style changes under the --preview style, following the stability policy?
  • [-] Add an entry in CHANGES.md if necessary?
  • [-] Add / update tests if necessary?
  • [y] Add new / update outdated documentation?

@cobaltt7 cobaltt7 added the skip news Pull requests that don't need a changelog entry. label Dec 29, 2025
@cobaltt7

This comment was marked as resolved.

@cobaltt7 cobaltt7 force-pushed the ci-refactors branch 2 times, most recently from a216316 to 7aa9f3a Compare December 29, 2025 22:43
@cobaltt7 cobaltt7 marked this pull request as draft December 30, 2025 00:40
@cobaltt7 cobaltt7 marked this pull request as ready for review December 31, 2025 20:34
@cobaltt7
Copy link
Collaborator Author

cobaltt7 commented Jan 1, 2026

All issues have been fixed, ready for review!

Copy link
Collaborator

@hauntsaninja hauntsaninja left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you! Looks good from a skim! (And happy new year! :-) )

…ctness

Signed-off-by: cobalt <61329810+cobaltt7@users.noreply.github.com>
Use them most places (some places are migrated in future commits)
Also bumps some action runner versions
And updates dependabot/pre-commit config to check for more updates
Remove second unnecessary mypy config

Signed-off-by: cobalt <61329810+cobaltt7@users.noreply.github.com>
Signed-off-by: cobalt <61329810+cobaltt7@users.noreply.github.com>
Signed-off-by: cobalt <61329810+cobaltt7@users.noreply.github.com>
Signed-off-by: cobalt <61329810+cobaltt7@users.noreply.github.com>
Signed-off-by: cobalt <61329810+cobaltt7@users.noreply.github.com>
Most notably:
- vim files (and Python heredocs)
- Sphinx attestations
- pyproject.toml

Signed-off-by: cobalt <61329810+cobaltt7@users.noreply.github.com>
- Standardize `/py(thon)?(3)?/` to `python`
- Only use `console` when output is shown, because it's very lacking compared to `sh`
- Add a few other missing languages

Signed-off-by: cobalt <61329810+cobaltt7@users.noreply.github.com>
Signed-off-by: cobalt <61329810+cobaltt7@users.noreply.github.com>
Cuts build times from ~45 to ~6 minutes
Reword PR comment to be clearer and more detailed
Work around Prettier format issues
Update docs appropriately

Signed-off-by: cobalt <61329810+cobaltt7@users.noreply.github.com>
@cobaltt7 cobaltt7 merged commit b41acd6 into psf:main Jan 16, 2026
90 checks passed
@cobaltt7 cobaltt7 deleted the ci-refactors branch January 16, 2026 04:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ci: build all wheels skip news Pull requests that don't need a changelog entry.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Split the Build and Publish workflow into more jobs

2 participants