Repository navigation
Replace Field(description=...) with proper docstrings in auth models #2053
Description
From the V2 checklist in #1253 (under "Refactor the auth way of using it"):
Drop the use of
Field(description=...), and use proper docstrings. As far as I know, we are not creating json schemas from it, so it's useless.
The auth-related Pydantic models currently use Field(description=...) to document fields. Since we are not generating JSON schemas from these models, the descriptions are not surfaced anywhere useful. They should be replaced with standard Python docstrings that are more discoverable via IDEs and help().
This is part of the broader auth refactor planned for V2.
Ref: Kludex's V2 checklist in #1253
Activity
pablopupo commentedon Jul 2, 2026
Happy to take this one. I'll swap Field(description=...) for field docstrings across the auth models and drop the Field() calls that end up empty once the description is gone.