improved readability and cleared sections which could have caused more confusion Co-authored-by: Eric Huss <eric@huss.org>