Convenções de escrita
Esqueleto de uma aula
Toda aula fica em aulas/aula-NN.qmd e começa com este cabeçalho:
---
title: "Variáveis instrumentais"
aula: 7
date: 2026-04-22 # opcional
description: "Endogeneidade, instrumentos e o estimador de Wald."
---O campo aula alimenta o rótulo “Aula 07” acima do título. Quando a aula tem leituras anotadas, o corpo segue três seções, nesta ordem. Uma aula sem leituras dispensa o rótulo “Anotações de aula”: os tópicos da aula ficam direto no nível 2 (## Tópico), e a simulação, se houver, vem no fim.
## Leituras
### @cunningham2021mixtape, cap. 7
> Citação literal, copiada da fonte. [@cunningham2021mixtape, p. 315]
Comentário curto sobre a citação.
## Anotações de aula
...
## Simulação
...Um subtítulo de nível 3 que começa com uma citação (### @chave) vira automaticamente um bloco de leitura, com o rótulo “Leitura” acima.
Citações literais
Citação é sempre literal, entre > e terminada com a referência e a página no formato [@chave, p. N]. Não corrija erros de digitação dentro de citações. Se o trecho estiver em outra língua, ele fica na língua original.
The experiment, too, was on the grandest scale. (Snow 1855, 75)
Os comentários entre as citações ficam em parágrafos normais. Para destacar um comentário mais longo, use o bloco comentario:
::: comentario
Aqui vai uma observação minha sobre a leitura.
:::Aqui vai uma observação minha sobre a leitura.
Referências
Há uma única bibliografia por disciplina, em references.bib, com chaves no formato sobrenomeANOpalavra (por exemplo, cunningham2021mixtape). Cada página lista as próprias referências no fim, e referencias.qmd reúne todas.
::: {#refs}
Num livro Quarto, um único ::: {#refs} em qualquer página transforma a bibliografia do livro inteiro numa lista só e esconde as referências das outras páginas. A checagem do CI falha se encontrar esse bloco.
Matemática
- Deixe uma linha em branco antes e depois de
$$. - Use
^\toppara transposta,\mathbb{E},\mathbb{V},\text{Cov}e\perp\!\!\!\perppara independência. - Para alinhar equações, use
aligneddentro de$$. - Resultados centrais podem ir numa caixa: \(\boxed{\hat\beta = (X^\top X)^{-1} X^\top y}\).
Estilo
As regras valem para os comentários e as anotações de aula, e não para as citações:
- sem negrito no corpo do texto, exceto na primeira ocorrência de um termo definido;
- sem travessão; use vírgulas, parênteses ou, no limite,
--; - títulos de seção em sentence case (“Anotações de aula”, e não “Anotações de Aula”);
- termos técnicos em inglês em itálico (survey, out-of-sample);
- números com vírgula decimal (0,05).
Texto escrito com IA
Explicações escritas com auxílio de IA ficam sempre dentro de nota-ia, que vira uma caixa recolhível identificada. O padrão é Claude, e o atributo ferramenta troca o nome:
::: {.nota-ia ferramenta="NotebookLM"}
Resumo do capítulo gerado pelo NotebookLM.
:::