[WIP] nice docs

[mfekadu]

accidental pull request while creating a PR template... will describe this better soon...

What's New?

Please include a summary of the change and which issue is fixed.
Please also include relevant motivation and context.
List any dependencies that are required for this change.

Fixes #<<ISSUE_NUMBER>> ... (e.g. #9)

Type of change (pick-one)

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update

How Has This Been Tested?

Please describe the tests that you ran to verify your changes.
Provide instructions so we can reproduce.
Please also list any relevant details for your test configuration

Checklist (check-all-before-merge)

formatting help: - [x] means "checked' and - [ ] means "unchecked"

• I added my tests to the /tests directory

• I documented my code according to the Google Python Style Guide

• I ran ./run_tests.sh and all the tests pass

• I ran ./format.sh because it automatically cleans my code for me 😄

• I ran ./lint.sh to check for what "format" missed

• I ran ./type_check.sh and got no errors

• I ran ./build_docs.sh and the docs look fine