TRF008

add_start_docstrings on a model class should not be empty.

   
Default Enabled
Scope All models
Source mlinter/trf008.py
Show in terminal mlinter --rule TRF008

What it does

Checks that add_start_docstrings on a model class gets a non-empty argument.

Why is this bad?

An empty argument produces unclear, low-quality generated API docs.

Example

-@add_start_docstrings("")
+@add_start_docstrings("The Acme model.")
 class AcmeModel(AcmePreTrainedModel):
     ...

Suppressing this rule

Add a # trf-ignore: TRF008 comment on the flagged line or the line directly above it. See Suppressing rules for whole-file directives and when a suppression is the wrong answer.