Clarity about caching

[oharar]

What would you like to do?

Report an issue on quarto.org

Description

On https://quarto.org/docs/computations/caching.html it is stated

You can also enable caching on a per-cell basis (in this you would not set the document level option)

for an example where the document-level option is cache: true and the cell-level is also true. It is not clear how broadly the parenthetical comment should be read: is it that when you have 'execute: \n cache: true' there is no point in setting a cell-level option 'cache: true', or is it that when you set a cell-level cache, you can't/shouldn't set the document-level option?

If the former, perhaps change the cell-level option in the example to 'cache: false', if the letter perhaps be more explicit, e.g. '(if you set a document-level caching option, you cannot change it at the chunk level)'?

[mcanouil]

Setting both document and code-cell level to true is not really useful as it leads to the exact same thing.
I believe the sentence is missing a word: 'in this example you would not set the document level option". (PR: quarto-dev/quarto-web#1881)

All code-cells options have higher priority over document or project-level options.