Open MiguelRodo opened 3 months ago
The final decision for organizing your documentation within the YAML configuration is as follows:
docs
keyword is reserved exclusively for rendered documentation (e.g., HTML files generated from qmd). This directory path is set to docs
(by default; can be changed).docs-
. For example:
docs-source
(for original source documents)docs-slides
(for presentation slides)docs-reports
(for reports)This approach provides a clear distinction between generated and non-generated documentation, while offering flexibility to accommodate various document types in a structured manner.
To do
docs-<subkey>
directories for non-rendered filesInitial thoughts
Not sure how this would look... But I usually have to add a
data-raw
docs
sub-directory for, e.g. scrap, scripts, presentations, etc.The one issue is that
docs
feels to me like a jargon term, for where we keep like our site (GitHub uses that as its default). So I want to keep the keyword for that, but it's ambiguous (if we opendocs
up to non-computed artefacts).Possible options:
1.
Gemini discussion
https://g.co/gemini/share/541165fe28d0