docs: jsonalchemy grammar and rewording

* Rewords sentences that were incomprehensible or hard to understand
  and splits long chunks of information into bullet points.

* Changes informal pronouns to formal.

* Fixes a triple-quote.

CC: @egabancho @jalavik