Functionality the class should provide: [describe the functionality]

Task: write a Python class that implements it.

Include:
- the definitions of all methods
- docstrings
- inline comments that explain the logic