Add and update docstrings in `section.py` module

[yousefmoazzam]

Fixes #516

Checklist

• [x] I have added tests that prove my fix is effective or that my feature works
• [x] New and existing unit tests pass locally with my changes
• [x] I have made corresponding changes to the documentation