---
id: griffe-typingdoc
version: "0.3.1"
license: ISC
license_treatment: permissive
maintenance: active
---

# griffe-typingdoc — Griffe extension for PEP 727 – Documentation Metadata in Typing.

License: permissive · Maintenance: active · Downloads: 88.0K/mo

## What it is and what it does

Griffe TypingDoc is a plugin for the Griffe documentation tool that extends mkdocstrings to support PEP 727 inline documentation metadata. It allows developers to document function parameters, class attributes, return types, and module-level variables directly within their type hints using Python's Annotated type, rather than relying solely on docstrings. This approach keeps documentation closer to the code and enables richer, more structured metadata.

The extension integrates into the mkdocstrings Python handler as a configuration option, processing Annotated hints during documentation generation. It depends on griffelib for core functionality and typing-extensions for compatibility across Python versions. The package is actively maintained and supports modern Python versions from 3.10 onward.

Use it for:

- Document function parameters inline using Annotated without writing separate docstring descriptions
- Add structured metadata to class attributes that gets rendered in generated API documentation
- Maintain documentation closer to type definitions for better code-documentation alignment
- Generate richer API docs in MkDocs projects that already use mkdocstrings
- Adopt PEP 727 conventions in a codebase to standardize documentation metadata format

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Griffe extension that enables inline documentation of function parameters, class attributes, return types, and variables using Python's Annotated type hint, following PEP 727 conventions.

Yes, if you use MkDocs with mkdocstrings and want to adopt PEP 727 inline documentation metadata. Low install friction, active maintenance, permissive license, and no known vulnerabilities make it safe to adopt. Not relevant if you don't use mkdocstrings or prefer traditional docstring-only documentation.

## Install

pip install griffe-typingdoc
uv add griffe-typingdoc
poetry add griffe-typingdoc

## Installing griffe-typingdoc

Before you install: Low friction install with only two runtime dependencies (griffelib and typing-extensions). Actively maintained with recent commits; last release 175 days ago. Supports Python 3.10 through 3.14.

License in practice: ISC license is permissive, allowing commercial and private use with minimal restrictions.

Quickstart:

pip install griffe-typingdoc

# In mkdocs.yml:
plugins:
  - mkdocstrings:
      handlers:
        python:
          options:
            extensions:
              - griffe_typingdoc

Requires Python 3.10 or later; intended for use within a MkDocs project with mkdocstrings configured.

Verify before relying:

- Whether this extension works with all mkdocstrings handlers or only the Python handler
- Compatibility with existing Griffe plugins and whether conflicts are possible
- Performance impact on documentation generation for large codebases

## Package facts

- License: ISC (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 88.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

PEP 727 documentation metadata, inline parameter documentation, annotated type hints documentation, griffe extension, mkdocstrings plugin, typed documentation generation, class attribute documentation, pep-727, mkdocs-plugin, type-hints

[View on SkillFed](https://skillfed.io/packages/griffe-typingdoc) · [View on PyPI](https://pypi.org/project/griffe-typingdoc/)