Phương pháp luận

Kho lưu trữ này hoạt động như thế nào.

kakao.io, Open Cacao Index, là một dự án dữ liệu mở độc lập, phi thương mại về ca cao như một cây trồng — cây Theobroma cacao, các vùng trồng của nó, và những con người cùng tập quán đứng sau nó. Đây là một kho lưu trữ tham khảo, không phải một cửa hàng, một danh bạ hay một trang quảng bá.

Đơn vị dữ liệu

Bản ghi cơ bản trong kho lưu trữ này là xuất xứ: một nơi sản xuất ca cao được xác định, có thể là một quốc gia, một vùng, hoặc một khu vực cụ thể hơn. Mỗi xuất xứ được cấp một định danh ổn định không thay đổi ngay cả khi tên, mô tả hay phân loại của nó sau này được sửa đổi. Các ID ổn định cho phép các bản ghi được trích dẫn, liên kết và đính chính theo thời gian mà không phá vỡ các tham chiếu.

Phân loại

Các xuất xứ được mô tả bằng khung cụm di truyền hiện đại hơn là mô hình Criollo / Forastero / Trinitario cũ. Khi một thuật ngữ truyền thống hoặc thương mại hữu ích, nó được ghi lại như vậy và được đánh dấu rõ ràng là vốn từ vựng lịch sử hoặc buôn bán, không phải một sự thật di truyền.

Tình trạng của dữ liệu

Mọi bản ghi trong kho lưu trữ này hiện tại là một bản nháp đang chờ xác minh nguồn. Các mục có thể chưa hoàn chỉnh, tạm thời hoặc sai, và chúng chưa nên được coi là có thẩm quyền. Khi các bản ghi được kiểm tra đối chiếu với các nguồn đã xuất bản, tình trạng của chúng sẽ được cập nhật.

Định dạng và giấy phép

Dữ liệu được giữ ở dạng JSON thuần để dễ đọc, kiểm tra và tái sử dụng. Nó dự định được phát hành theo giấy phép Creative Commons Attribution 4.0 (CC BY 4.0), cho phép tái sử dụng có ghi công.

Đính chính

Các đính chính và bổ sung được hoan nghênh. Đây là một kho lưu trữ giai đoạn đầu được duy trì công khai, và sự góp ý từ những người có kinh nghiệm thực địa, buôn bán hoặc nghiên cứu được trân trọng.