Editing File: /opt/cloudlinux/venv/lib/python3.11/site-packages/pydocstyle/data/imperatives_blacklist.txt

# Blacklisted imperative words
#
# These are words that, if they begin a docstring, are a good indicator that
# the docstring is not written in an imperative voice.
#
# The words included in this list fall into a number of categories:
#
# - Starting with a noun/pronoun indicates that the docstring is a noun phrase
#   or a sentence but not in the imperative mood
# - Adjectives are always followed by a noun, so same
# - Particles are also followed by a noun
# - Some adverbs don't really indicate an imperative sentence, for example
#   "importantly" or "currently".
# - Some irregular verb forms that don't stem to the same string as the
#   imperative does (eg. 'does')
a
an
the
action
always
api
base
basic
business
calculation
callback
collection
common
constructor
convenience
convenient
current
currently
custom
data
data
default
deprecated
description
dict
dictionary
does
dummy
example
factory
false
final
formula
function
generic
handler
handler
helper
here
hook
implementation
importantly
internal
it
main
method
module
new
number
optional
placeholder
reference
result
same
schema
setup
should
simple
some
special
sql
standard
static
string
subclasses
that
these
this
true
unique
unit
utility
what
wrapper

# These are nouns, but often used in the context of functions that act as
# objects; thus we do not blacklist these.
#
# context  # as in context manager
# decorator
# class  # as in class decorator
# property
# generator

Back to Directory