[Bug]: Base class in emitted Python code has doc strings like "Remove all items from D"... don't know what "D" stands for

[dargilco]

Describe the bug

Emitted Python code has this in the class class _MyMutableMapping(MutableMapping[str, typing.Any]): in file model_base.py:

    def clear(self) -> None:
        """
        Remove all items from D.
        """
        self._data.clear()

Not clear what "D." means. I also see this is in doc string of some other methods/properties in this class.

See for example latest azure-ai-projects ref APIs: https://learn.microsoft.com/en-us/python/api/azure-ai-projects/azure.ai.projects.models.a2apreviewtool?view=azure-python#azure-ai-projects-models-a2apreviewtool-clear

TypeSpec for this emitted code is here: https://github.com/Azure/azure-rest-api-specs/tree/feature/foundry-release/specification/ai-foundry/data-plane/Foundry

Reproduction

.

Checklist

• Follow our Code of Conduct
• Check that there isn't already an issue that request the same bug to avoid creating a duplicate.
• Check that this is a concrete bug. For Q&A open a GitHub Discussion.
• The provided reproduction is a minimal reproducible example of the bug.

[github-actions]

🎯 Issue Triage

The Python client emitter generates a model_base.py file containing a _MyMutableMapping class with docstrings like "Remove all items from D.", where "D" is an unclear reference (likely inherited from Python's standard MutableMapping docstring convention where D denotes the mapping instance itself).

Category: Bug

Area: emitter:client:python

⚠️ No reproduction provided. Since this is a code generation issue, a minimal TypeSpec input that triggers the generation of model_base.py (e.g., any model using a Record<> or dictionary-typed field) would help confirm the exact code path.

🔍 Analysis

• The _MyMutableMapping class in model_base.py implements MutableMapping[str, Any] and its docstrings appear to be copied from Python's MutableMapping ABC, where method docs use D as a shorthand for the dictionary/mapping instance (e.g., D.clear() -> None -- remove all items from D).
• When the emitter copies these docstrings verbatim, the D reference loses all context for end users reading the generated SDK documentation.
• This affects the public documentation of generated Azure SDK models (as shown in the referenced Azure AI Projects API docs: azure.ai.projects.models.A2APreviewTool.clear).
• Affected file: model_base.py — the shared base module emitted by @typespec/http-client-python.
• The fix would involve either rewriting those docstrings to be self-contained (e.g., "Remove all items from this mapping.") or removing the unclear ones.

📝 Suggested next steps

• Locate the docstring template(s) for _MyMutableMapping in the http-client-python emitter source (likely a hardcoded template or Jinja2 snippet).
• Replace "D." references with self-referential language (e.g., "this mapping") in all affected method/property docstrings.
• Verify the fix applies to all emitted model_base.py variations.

Generated by Agentic Triage