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>