Metodologia

Como este arquivo funciona.

O kakao.io, o Open Cacao Index, é um projeto de dados abertos independente e não comercial sobre o cacau enquanto cultura — a árvore Theobroma cacao, suas regiões produtoras e as pessoas e práticas por trás dela. É um arquivo de referência, não uma loja, um diretório ou um site promocional.

A unidade de dados

O registro básico neste arquivo é a origem: um lugar produtor de cacau definido, que pode ser um país, uma região ou uma área mais específica. Cada origem recebe um identificador estável que não muda mesmo que seu nome, sua descrição ou sua classificação sejam posteriormente revisados. IDs estáveis permitem que os registros sejam citados, vinculados e corrigidos ao longo do tempo sem quebrar referências.

Classificação

As origens são descritas usando o moderno enquadramento de agrupamentos genéticos, em vez do antigo modelo Criollo / Forastero / Trinitario. Onde um termo tradicional ou comercial é útil, ele é registrado como tal e claramente marcado como vocabulário histórico ou comercial, não como um fato genético.

Situação dos dados

Todo registro neste arquivo é atualmente um rascunho pendente de verificação de fontes. As entradas podem estar incompletas, ser provisórias ou estar erradas, e ainda não devem ser tratadas como autoritativas. À medida que os registros são verificados em relação a fontes publicadas, sua situação será atualizada.

Formato e licença

Os dados são mantidos como JSON simples para que sejam fáceis de ler, validar e reutilizar. Pretende-se publicá-los sob a licença Creative Commons Atribuição 4.0 (CC BY 4.0), permitindo a reutilização com atribuição.

Correções

Correções e acréscimos são bem-vindos. Este é um arquivo em estágio inicial mantido de forma aberta, e a revisão por pessoas com experiência de campo, comercial ou de pesquisa é valorizada.