Skip to content

Fix documentation cross-linking inventory versions - #301

Merged
llucax merged 1 commit into
frequenz-floss:v1.x.xfrom
llucax:fix-docs-inventories
Sep 17, 2026
Merged

llucax merged 1 commit into
frequenz-floss:v1.x.xfrom
llucax:fix-docs-inventories

Conversation

@llucax

@llucax llucax commented Sep 17, 2026

Copy link
Copy Markdown
Contributor

The mkdocstrings inventories pointed to older versions of the dependencies' documentation than the minimum versions declared in pyproject.toml, so symbols added later, like TargetComponents from frequenz-client-dispatch (present since v0.11 but linked to v0.6), could not be resolved. The frequenz-client-base inventory was also missing entirely.

This updates the inventories to match the minimum dependency versions (frequenz-channels v1.6, frequenz-client-dispatch v0.11), adds the frequenz-client-base v0.11 inventory, and fixes the pyproject.toml comment that still referred to the old import config key (now inventories).

Fixes #300.

@llucax
llucax requested a review from a team as a code owner September 17, 2026 07:48
@llucax
llucax requested review from ela-kotulska-frequenz and removed request for a team September 17, 2026 07:48
@github-actions github-actions Bot added part:docs Affects the documentation part:tooling Affects the development tooling (CI, deployment, dependency management, etc.) part:dispatcher Affects the high-level dispatcher interface labels Sep 17, 2026
@llucax llucax added this to the v1.0.4 milestone Sep 17, 2026
@llucax llucax self-assigned this Sep 17, 2026
@llucax

llucax commented Sep 17, 2026

Copy link
Copy Markdown
Contributor Author

Fixed screenshot:

image

@llucax
llucax enabled auto-merge September 17, 2026 07:51
@llucax
llucax disabled auto-merge September 17, 2026 08:14
The mkdocstrings inventories pointed to older versions of the
dependencies' documentation than the minimum versions declared in
pyproject.toml, so symbols added later, like `TargetComponents` from
`frequenz-client-dispatch` (present since v0.11 but linked to v0.6),
could not be resolved. The `frequenz-client-base` inventory was also
missing entirely.

Update the inventories to match the minimum dependency versions, add
the `frequenz-client-base` inventory, and fix the pyproject.toml
comment that still referred to the old `import` config key, now called
`inventories`.

Fixes frequenz-floss#300.

Signed-off-by: Leandro Lucarella <luca-frequenz@llucax.com>
@llucax

llucax commented Sep 17, 2026

Copy link
Copy Markdown
Contributor Author

Updated, needs a new approval.

@llucax
llucax added this pull request to the merge queue Sep 17, 2026
Merged via the queue into frequenz-floss:v1.x.x with commit e1169fb Sep 17, 2026
9 checks passed
@llucax
llucax deleted the fix-docs-inventories branch September 17, 2026 08:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

part:dispatcher Affects the high-level dispatcher interface part:docs Affects the documentation part:tooling Affects the development tooling (CI, deployment, dependency management, etc.)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Documentation cross-linking uses old versions

2 participants