René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"bug: Closing parenthesis missing for PEP 695 type parameters with docstring_section_style: list","articleBody":"### Description of the bug\n\nWhen 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. \n\nThe 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.\n\n### To Reproduce\n\nConfiguration (`mkdocs.yml`):\n\n```yaml\nplugins:\n  - mkdocstrings:\n      handlers:\n        python:\n          options:\n            docstring_style: google\n            docstring_section_style: list\n            show_signature: true\n            show_signature_annotations: true\n```\n\nModule:\n\n```python\nclass Entity[TId: Hashable, M: Snapshot, S: State]:\n    \"\"\"An entity.\n\n    Type parameters:\n        TId (Hashable): Type of the entity identifier.\n        M (Snapshot): Snapshot type returned by to_snapshot().\n        S (State): Internal state type that holds internal mutable data.\n    \"\"\"\n```\n\nSteps:\n\n1. Use the configuration and module above.\n2. Add `::: module.Entity` to a Markdown page.\n3. Run `mkdocs build` and open the generated page.\n4. Look at the Type parameters section. The closing `)` is missing after each bound.\n\nRemoving `griffe_typingdoc` from the extensions and renaming the heading to `Type Parameters:` do not change the output.\n\n### Full traceback\n\nNo traceback. The build completes without errors or warnings.\n\n### Expected behavior\n\nEach type parameter is shown with its bound in parentheses, for example `TId (Hashable) – Type of the entity identifier.`\n\n### Environment information\n\npython -m mkdocstrings_handlers.python._internal.debug\n- __System__: macOS-14.7.2-x86_64-...\n- __Python__: cpython 3.13.9 (.../.venv/bin/python)\n- __Environment variables__:\n- __Installed packages__:\n  - `mkdocstrings-python` v2.0.10\n\nOUTPUT\n```text\nClass Type Parameters:\n\nTId (Hashable– Type of the entity identifier.\nM (Snapshot– Snapshot type returned by to_snapshot().\nS (State– Internal state type that holds internal mutable data.\n```\n\n### Additional context\n\nVersions: mkdocstrings-python 2.0.10, griffelib 2.4.1, griffe not installed. \n\nThe `table` layout output for the same class is:\n\n| Name | Bound or Constraints | Description | Default |\n| --- | --- | --- | --- |\n| TId | Hashable | Type of the entity identifier. | required |\n| M | Snapshot | Snapshot type returned by to_snapshot(). | required |\n| S | State | Internal state type that holds internal mutable data. | required |\n````_\n","author":{"url":"https://github.com/vadzimk","@type":"Person","name":"vadzimk"},"datePublished":"2026-11-11T18:08:21Z","url":"https://github.com/mkdocstrings/python/issues/349"}