A little more context:
> “To explicitly specify a rest’s vertical position, write a note followed
> by \rest.”
> While this is a useful thing to know about, I don't personally believe it's a
> best practice: it mixes content with presentation, it doesn't play well with
> \transpose, etc.
Consider, for example, the following two snippets:
\transpose c f \voices 1,2 <<
{ \tweak Y-offset 1 r8 b e' d' }
\\
{ g16^1 f^2 g a }
>>
\transpose c f \voices 1,2 <<
{ c''8\rest b e' d' }
\\
{ g16^1 f^2 g a }
>>
Cheers,
Kieren.