Feature/update docstrings

Quality of life improvements for the documentation, better ignore rules for vale, and all code documentation now is adapted to the new style

requested review from @mohammad.torkashvand

assigned to @karel.vanklink

resolved all threads

approved this merge request

added 7 commits

• 0687983c...383fec8e - 3 commits from branch develop
• 97f8ab1e - Use extension for generating links that open in a new tab
• 7b9ed275 - Update docstrings in a few product blocks
• 5cad4fb0 - Update docstrings in a more product blocks, remove obsolete :class:`` references
• 8e080399 - Update docstrings to be added in mkdocs

Compare with previous version

merged