Macro Notebook To Qmd

Writing Constraints

Keep teaching prose:

• concise and direct
• interpretation-first after each output
• explicit about definitions and units
• written in European Portuguese (pt-PT)

Avoid:

• dumping exploratory dead-ends
• leaving notebook scratch comments
• introducing new datasets not listed in manifest

Caption and Label Standards

For every major output:

• include a fig-cap or table caption
• include location and period in caption when relevant
• use consistent label prefixes (fig-, tbl-)
• match baseline figure/table styling from 01_portugal_eurostat.qmd and 02_portugal_contas_nacionais_plus.qmd
• for Plotly charts, keep template="plotly_white" and centered chart titles (title_x=0.5) unless a justified exception exists

If a figure is exploratory and not publication-worthy, exclude it.

Reproducibility Rules

Ensure:

• deterministic imports and transformations
• no hidden manual edits required between runs
• execute options match repository defaults unless manifest states otherwise

If the notebook depends on local files, document file origin and expected path in module text or comments.

Language Allowance

Allow technical terms in English only when they are standard in economics usage. Prefer Portuguese wording first and include English terms in parentheses when useful.

Output

Produce:

• NN_topic_slug.qmd ready for integration.
• Short checklist noting:
  • what from notebook was included
  • what was intentionally excluded
  • any unresolved caveats
  • language compliance (pt-PT)
  • style compliance against modules 01_ and 02_