You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
bug: Closing parenthesis missing for PEP 695 type parameters with docstring_section_style: list #349
When a PEP 695 generic class has a Type parameters: docstring section and docstring_section_style is set to list, the closing parenthesis after each type parameter's bound is missing from the rendered page.
The output is TId (Hashable – Type of the entity identifier. instead of TId (Hashable) – Type of the entity identifier.. The generated HTML also does not contain the ). Switching to docstring_section_style: table renders all three type parameters correctly, so the bug appears to be in the list section template.
classEntity[TId: Hashable, M: Snapshot, S: State]:
"""An entity. Type parameters: TId (Hashable): Type of the entity identifier. M (Snapshot): Snapshot type returned by to_snapshot(). S (State): Internal state type that holds internal mutable data. """
Steps:
Use the configuration and module above.
Add ::: module.Entity to a Markdown page.
Run mkdocs build and open the generated page.
Look at the Type parameters section. The closing ) is missing after each bound.
Removing griffe_typingdoc from the extensions and renaming the heading to Type Parameters: do not change the output.
Full traceback
No traceback. The build completes without errors or warnings.
Expected behavior
Each type parameter is shown with its bound in parentheses, for example TId (Hashable) – Type of the entity identifier.
Class Type Parameters:
TId (Hashable– Type of the entity identifier.
M (Snapshot– Snapshot type returned by to_snapshot().
S (State– Internal state type that holds internal mutable data.
Additional context
Versions: mkdocstrings-python 2.0.10, griffelib 2.4.1, griffe not installed.
The table layout output for the same class is:
Name
Bound or Constraints
Description
Default
TId
Hashable
Type of the entity identifier.
required
M
Snapshot
Snapshot type returned by to_snapshot().
required
S
State
Internal state type that holds internal mutable data.
Activity
vadzimk commentedon Nov 11, 2026
Related to #221
fix: Add missing closing parenthesis around type parameter type
pawamoy commentedon Nov 12, 2026
Thanks for the report @vadzimk, fixed in ecfd54d 🙂