Documentation: Better documentation of yaw_optimizer_sr.py

# Documentation: Better documentation of yaw_optimizer_sr.py

The file `yaw_optimizer_sr.py` could use better in-place documentation and complete docstrings. 

## Proposed solution
 Recommend to go through file and:

- Add docstrings
- Remove commented blocks of code
- Add type hints
- Add comments where helpful


## Additional context
Would be helpful for questions like #1013 
