grooming code

[amites]

This PR closes n/a

What does this PR do?

Grooming code structure while creating docs

How does this PR make you feel? :link:

![good]

[netlify[bot]]

👷 Deploy request for upswyng pending review. Visit the deploys page to approve it

🔨 Explore the source changes: 3eae40122bf1a332bedc850c634d5b74783005ea

[amites]

removed all the logic changes adding await commands and left all the pure "grooming"

added a bunch of comments to help simplify review -- let me know if ya need to break this down further