Basically something that makes it easy to read the value of each aesthetic mapping and which has consistent indentation (indenting out to parens on previous lines, by contrast, creates long lines and indentation amounts that don't reflect indentation level). The advantage of the pipe forms is that if you need to insert other data transformations ahead of the ggplot call you can do so, but if no examples end up needing that it's probably not necessary.
Some things that it needs:
[ ] Readable, consistent code style, especially to make it easy to see the parts of a spec. I'd suggest something like:
or:
or:
Basically something that makes it easy to read the value of each aesthetic mapping and which has consistent indentation (indenting out to parens on previous lines, by contrast, creates long lines and indentation amounts that don't reflect indentation level). The advantage of the pipe forms is that if you need to insert other data transformations ahead of the ggplot call you can do so, but if no examples end up needing that it's probably not necessary.