From #4936, it's hard to know where some of the options on the book structure page should go, e.g. section numbers:
go under a format or in a document, not under book.
Consider some combination of the following:
- Could use
filename to disambiguate: using _quarto.yml for book options, and chapter-1.qmd for document level yaml.
- Could include more context in all YAML snippets: e.g. always explicitly include option hierarchy starting at
for book options.
- Be explicit in Overview that some options are
book ones and some are relevant format ones, and describe conventions used in examples.
- Be more explicit with the introduction of each example whether something is a
book option or format option.
- Reorder page to first talk about all relevant
book options, then talk about format options. Be explicit about this ordering in Overview.
From #4936, it's hard to know where some of the options on the book structure page should go, e.g. section numbers:
go under a
formator in a document, not underbook.Consider some combination of the following:
filenameto disambiguate: using_quarto.ymlforbookoptions, andchapter-1.qmdfor document level yaml.bookones and some are relevantformatones, and describe conventions used in examples.bookoption orformatoption.bookoptions, then talk aboutformatoptions. Be explicit about this ordering in Overview.