Skip to content

chore: move documentation dependencies into their own group - #3556

Open
badja-dev wants to merge 1 commit into
fix/pin-git-dependenciesfrom
chore/split-docs-dependencies
Open

chore: move documentation dependencies into their own group#3556
badja-dev wants to merge 1 commit into
fix/pin-git-dependenciesfrom
chore/split-docs-dependencies

Conversation

@badja-dev

@badja-dev badja-dev commented Sep 8, 2026

Copy link
Copy Markdown
Member

What type of PR is this?

  • Bug Fix (non-breaking change which fixes an issue)
  • Feature/Tweak (non-breaking change which adds new functionality or enhances existing functionality)
  • Breaking Change (fix or feature that would break any existing functionality for users)
  • Documentation Update
  • Chore (maintenance, dependency bumps, housekeeping - no functional change)
  • Other

Description

[project].dependencies declared 42 packages, 17 of which are the mkdocs documentation toolchain. Stack 4 of 5, based on #3555.

None of those 17 are imported anywhere in modules/ or kometa.py. They exist only to build the documentation site. This moves them into a docs dependency group. docs is not a default group, so uv sync no longer pulls the documentation stack into a runtime environment.

After the split, [project].dependencies and requirements.txt agree exactly:

[project].dependencies: 25    requirements.txt: 25
in pyproject only: none
in requirements only: none
version specifier mismatches: none

Two lists that have been maintained by hand in separate files now match package for package and specifier for specifier.

docs/requirements.txt is unchanged, so the Read the Docs build is unaffected.

This is a prerequisite for #3557, which generates requirements.txt from the lockfile. Without the split, the generated file would pull the entire documentation stack into every image.

No CHANGELOG entry: no user-facing change.

Have you updated the Documentation to reflect changes (if necessary)?

  • Yes
  • No
  • Not Applicable

Have you updated the JSON Schema files (if necessary)?

  • Yes
  • No
  • Not Applicable

Have you updated the CHANGELOG.md?

  • Yes
  • No

@badja-dev badja-dev changed the title WIP 4: split documentation dependencies into their own group chore: move documentation dependencies into their own group Sep 8, 2026
@badja-dev
badja-dev force-pushed the chore/split-docs-dependencies branch from f00a899 to cdd48db Compare September 8, 2026 21:37
@badja-dev
badja-dev marked this pull request as ready for review September 8, 2026 21:50

@chazlarson chazlarson left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

LGTM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants