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.

Signed-off-by: Dimitrios Semitsoglou-Tsiapos <dsemitso@cern.ch>