refactor: fix typos, better variable naming, markdown linter

[k-yang]

No functional changes were made.

I cleaned up the variable names and made some functions easier to read. I also fixed some typos in the function docs. Then I ran a linter on the README file.