Indentation is hard to read

[ekampp]

I'm seeing some confusion on Discord about the whitespace being hard to read.

It seems to assume that it will be read from the top, and the user will add keys and indentation as they go along.

But if you jump into a section that's deeply nested, the example may simply be key: value

I would love to spark a conversation about how to make the whitespace more readable, or provide something like JSON path hints to the sections.

[ekampp]

Some keys, may be used multiple places, and this leads to ambiguity about the possible values.

[alexandrunastase]

Maybe providing richer examples, that include more of the tree could improve this. Unless you have some context it's kinda hard to figure out sometimes where that particular key should fit in, especially given the upgrade to version 2, which changes a few things around, even more.