Tricky inline computations

[fkohrt]

I feel like participants are bound to trip over instances of quarto-dev/quarto-cli#10595. Should we add the peculiarities of using `{r} ...` under possible problems? Or directly recommend using `r ...`?

[FlorianPargent]

In commit 1fcd417 I have added a comment to the relevant section that we recommend `r ...`, briefly mention the most important difference and link to the inline code documentation.