You can configure sphinx if that's what you are using for documentation to document __init__ method separately, however, the default is to use the documentation for the class to describe that. I don't like the default and usually configure sphinx not to do that, but you need not do the same. If you are going with defaults, then the class documentation may include :ivar : for class fields. You can also include :param <__init__ param>: in that documentation to document parameters supplied to __init__. The other thing: you misinterpreted type annotation to have some procedural semantics. What it means is that self._instance is believed to have a type of list with elements being of type Service (it's actually wrong, because the code doesn't need it to be a list, it just needs to be something that has methods copy() and append(), but this kind of mistake is very typical of Python as of late. More on reddit.com

Docstrings are easily obtainable by other Python tools dynamically just by inspecting your objects. This is useful for tools that do things like generating API documentation. Comments are, by comparison, more difficult for such tools to use in part because comments are discarded by the compiler whereas docstrings are a part of your object (see .__doc__ attribute of any function, class, etc.). They're not necessarily interchangable tools, however. They're different tools for different purposes. Also, docstrings only work in certain places like at the very beginning of modules, classes, or functions. Comments, on the other hand, can be placed anywhere. More on reddit.com

There's this https://peps.python.org/pep-0257/ More on reddit.com

If you write a function that is 1 or 2 lines long, does it still need a docstring? If so, what needs to be in the docstring? probably. depending on the tools used the docstring can become important. at most.. it doesn't hurt.. and takes like few seconds to do it... so .. if not the functions/methods .. at least the class. almost all the time, when i go looking into packages and find what i'm looking for .. they have wonderful descriptions of the classes .. it is incredibly helpful to try and understand what the creator of the code wanted to do . i find them particularly useful. More on reddit.com