Include how to parse JSON, and where the val json comes from. Fixes #…

[graingert]

Pull Request Checklist

• Have you read How to write the perfect pull request?
• Have you read through the contributor guidelines?
• Have you signed the Lightbend CLA?
• Have you [squashed your commits]? (Optional, but makes merge messages nicer.)
• Have you added copyright headers to new files?
• Have you checked that both Scala and Java APIs are updated?
• Have you updated the documentation for both Scala and Java sections?
• Have you added tests for any changed functionality?

Helpful things

Fixes

Fixes #6540

Purpose

Include how to parse JSON, and where the val json comes from, in the JsonTransformer docs

…6540

[schmitch]

I'm not sure about the change. I would keep the Json as is and a note below in a second snippet on how to get the raw json to a JsValue.

[graingert]

Not sure about that. The JSON seems to stand on its own and unrelated to the rest of the documentation

[schmitch]

Actually it's just the example Json (and not any parsed value) which will be used in the examples. The Json Transfomers is actually a more advacned use case and if you are at that page you should've probably understood the previous pages and know how to get a parsed JsValue from Json. Also the text clearly says what it is "in the samples below we use that json"

[graingert]

Sure, but it's unclear. I got confused. It would be much better to refer to ’that json’ by an actual val.

Ideally I'd like to be able to paste the examples into my Scala repl and have them 'just work'

[cchantep]

@graingert as indicated previously, the way to parse a String as JsValue is explained in the first example of the JSON documentation, which is recommanded to get started (for this reason and others) before going on with more advanced usages. So before submitting such PR, please discuss it on the MailingList to figure out if/how a change could be useful. Best regards.

[AkashicSeer]

too bad they didn't listen to this guy and people like him. This seems to be the mentality too often. I'm over it.