Merge pull request #148 from skyflowapi/joe-2024-04-26

README rewrite to satisfy [CUST-2328] as well as improve overall readability.
Also fixed a couple of examples, made variable names consistent, and resolved a couple of typos.