fix(policy): policy devel lint --format removes the comments

[Piskoo]

This PR solves problem with comments being removed when --format is used.
Example policies in docs were re-linted with the tool.

Closes #2320

[migmartri]

Awesome, do you mind explaining a little bit more about how you solved the issue?

Do you think it's ok to remove protoyaml? I remember something like it had built-in validation (the annotations in the yaml files) of the proto object, I guess we've lost that?

[migmartri]

why do we have more spaces now?

Do ew want to have 4 instead of 2? I personally like 2 spaces, any reason for using 4?

[migmartri]

#2333 (comment)

[Piskoo]

seems like a bug, must have missed this, thanks!

[Piskoo]

Awesome, do you mind explaining a little bit more about how you solved the issue?

Do you think it's ok to remove protoyaml? I remember something like it had built-in validation (the annotations in the yaml files) of the proto object, I guess we've lost that?

Protoyaml is still used so the validation is present. The issue was solved with another library that allows unmarshaling yaml into yaml nodes and then traversing those nodes to update only the embedded policies. This adds some overhead because yaml gets unmarshaled twice when --format is used, but due to limitations present in both libraries that's the only way I found to preserve the comments.

[migmartri]

Thanks, let's make sure we keep two spaces