clarify some portion of the code

[jmborr]

Description of the changes

References:

Manual test for the reviewer

Check list for the reviewer

• best software practices
  • clearly named variables (better to be verbose in variable names)
  • code comments explaining the intent of code blocks
• All the tests are passing
• The documentation is up to date
• code comments added when explaining intent

Check list for the pull request

• source refactored/incremented
• tests for my changes
• updated the documentation accordingly

[codecov-commenter]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 35.43%. Comparing base (0778686) to head (e2b4871).

Additional details and impacted files

@@           Coverage Diff           @@
##             next      #99   +/-   ##
=======================================
  Coverage   35.43%   35.43%           
=======================================
  Files          30       30           
  Lines        6067     6067           
=======================================
  Hits         2150     2150           
  Misses       3917     3917           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.