Suggested minor improvements in the documentation 'Dynamic Metadata in Quarto Documents'

[joanbadia]

The dynamic metadata documentation is very well written and the first example of use and its output it's very helpful.

I have minor suggestions:

1. R chunks in the example do not properly show the #| options. This is probably simply a formatting thing because there's an explicit mention to it, e.g.: Note the #| output: asis chunk option - this is essential:)
2. The examples chosen do not show the full range of possibilities that this new functionality offers. Even updating the parameters outside of the document via quarto render test.qmd -P ... benefits from this new functionality (thanks to the sequential order in which code is executed). There are two veiled references to this: This functionality addresses a key limitation where Quarto metadata must traditionally be static and defined in the document header and And so, it wll make the metadata available for use throughout the document., but I think the documentation would benefit from a more explicit mention.
3. While the email variants example demonstrates the new functionality, readers unfamiliar with Posit Connect or the Quarto Email Extension might benefit from brief contextual links to related documentation.

I would say that had I read this documentation earlier, when I learnt about the existence of quarto::write_yaml_metadata_block, I wouldn't have required assistance applying this to my use case.

[cderv]

Thanks a lot !

[cderv]

I have updated the vignette thanks a lot
https://quarto-dev.github.io/quarto-r/articles/dynamic-metadata.html

[remlapmot]

This is fantastic. Maybe in the second code chunk you should add the quarto namespace qualifier to the write_yaml_metadata_block() function call as you have done in the subsequent code chunks it's used.

Also would you know how long has this when-meta attribute been available in Quarto? It's really useful.

[cderv]

Thank you @remlapmot! Updated!

Also would you know how long has this when-meta attribute been available in Quarto? It's really useful.

It has been a few versions already.

[remlapmot]

Thanks!

[remlapmot]

Just to say thanks for this again - it has enabled me to work out how to make tutorial documents using Quarto profiles https://remlapmot.github.io/post/2025/quarto-profiles-for-tutorials/. And I show how to write the dynamic metadata for 3 other Quarto engines (engine: julia, jupyter: python3, and jupyter: nbstata).

[cderv]

Thanks for sharing ! Nice to read such post on using Quarto !

I found that I could achieve what I wanted except for modifying the execute state of the Quarto document, it seems that must be specified in the first YAML block/header.

About this, I believe you could pass those variables using --metadata or --metadata-file at command line.

But using Profile is definitely better and meant for switching rendering context like you did.

[remlapmot]

Oh yes, thanks for pointing that out - I have added a correction about that - thanks!