Princípios de reprodutibilidade

Padrão mínimo de documentação, versionamento e método para projetos publicados neste portfólio.

Princípios de reprodutibilidade

Neste portfólio, reprodutibilidade significa que outra pessoa consegue entender o problema, ver quais dados foram usados, acompanhar as decisões metodológicas e achar o código ou a documentação quando houver repositório público.

Padrão mínimo

Dimensão O que a página deve informar
Pergunta Qual problema substantivo orienta a análise
Dados Fonte, período, unidade de análise e principais limites
Método Estratégia analítica, ferramentas e decisões relevantes
Status Estágio real do projeto
Repositório Link para código e documentação quando estiverem públicos
Limitações Cuidados de interpretação, lacunas e próximos passos

Organização recomendada

  • Separar dados brutos, dados tratados, scripts e relatórios.
  • Documentar fontes e filtros aplicados.
  • Evitar publicar dados sensíveis ou bases com restrição de uso.
  • Registrar dependências de R ou Python quando o projeto exigir execução.
  • Manter README claro em projetos que tenham repositório próprio.
  • Usar licença e instruções de citação quando o projeto ganhar maturidade.

Critério de publicação

Um projeto não precisa estar concluído para entrar no portfólio, mas precisa ser legível. A página deve dizer o que já existe, o que ainda falta e o que a análise já permite afirmar naquele estágio.