Evidencia
Cada afirmación sustantiva de este proyecto lleva un nivel de evidencia. Desconocido es una respuesta válida y respetable; la certeza inventada es el peor resultado (PRD §6.2).
La escala de evidencia
Sección titulada «La escala de evidencia»| Nivel | Significado | Ejemplo de redacción |
|---|---|---|
| Conocido | Hecho establecido con consenso amplio entre varias fuentes independientes (p. ej., biología básica, química, agronomía bien asentada) | «La chía es una planta de día corto.» |
| Fuerte | Varias fuentes consistentes y de alta calidad (p. ej., estudios replicados o varios informes prácticos independientes) con condiciones parecidas | varios estudios informan… |
| Moderado | Pocas fuentes buenas, o una fuente de alta calidad; cierta consistencia | un ensayo de campo informó… |
| Limitado | Una o pocas fuentes de calidad media-baja; confirmación limitada | un único informe de cultivador… |
| Anécdota | Informes personales o comunitarios sin verificar; plausibles pero sin comprobar | un usuario de un foro informa… |
| En conflicto | Desacuerdo genuino entre fuentes en condiciones comparables — registra ambos, no promedies (ver más abajo) | El estudio A informa X; el estudio B informa Y |
| Desconocido | No se encontró información fiable | aún no se sabe |
| Requiere experimento | La pregunta es respondible pero la evidencia falta o está en conflicto; un experimento original merece la pena | se necesita un ensayo a pequeña escala |
Dos dimensiones extra en cada afirmación
Sección titulada «Dos dimensiones extra en cada afirmación»- Tipo de evidencia: científica (estudio controlado, medición formal) vs práctica (demostración de cultivador, técnica manual) — no son intercambiables (PRD §6.6).
- Contexto: condiciones bajo las que se cumple la afirmación — cultivar, lugar, clima, fecha, densidad, riego, fertilización, diseño, fuente. Un número sin contexto es engañoso (PRD §6.4).
Cómo etiquetar afirmaciones
Sección titulada «Cómo etiquetar afirmaciones»Estilo en línea preferido, mantenido compacto:
Rendimiento informado: 1.200 kg/ha — Moderado · científico — cultivar X, secano, España, 2019 (S-0117).
Abreviaturas acordadas: K Conocido · S Fuerte · M Moderado · L Limitado · A Anécdota · C En conflicto · U Desconocido · E Requiere experimento. Usa la abreviatura en los datos estructurados (evidence: M) y la forma completa en la prosa narrativa.
Mapeo a datos estructurados
Sección titulada «Mapeo a datos estructurados»Los valores de data/crops/*.yaml llevan el nivel de evidencia de su afirmación fuente. Un campo es:
- un valor + evidencia + procedencia (p. ej.,
optimal_min_c: { value: 16, evidence: M, source: [S-0117] }), o null/unknowncuando no hay ninguno.
Las herramientas (UI de comparación, etc.) nunca deben mostrar un valor sin evidencia como hecho; deben representar el nivel y ocultar o marcar los campos unknown.
Preservar el desacuerdo
Sección titulada «Preservar el desacuerdo»Resultados diferentes bajo condiciones diferentes no son contradicciones — son información. Las diferencias pueden venir de cultivar, temperatura, fotoperiodo, suelo, fertilización, riego, densidad, fecha de siembra, lluvia, enfermedad, momento de cosecha o diseño experimental (PRD §6.3).
Reglas:
- Registra cada resultado con sus condiciones.
- Señala explícitamente la causa o causas probables de la diferencia.
- No promedies números en conflicto en un único valor «típico» hasta entender las condiciones que causaron la diferencia.
- Cuando publiques un valor típico/rango (p. ej., en datos estructurados), indica las condiciones que cubre y enumera el desacuerdo.
Nivel de evidencia de una página vs. de una afirmación
Sección titulada «Nivel de evidencia de una página vs. de una afirmación»Las páginas no tienen un único nivel de evidencia — son contenedores de afirmaciones, cada una con su nivel. Una página general puede resumir («temperatura óptima de germinación ≈ 18–25 °C»), pero debe enlazar a las afirmaciones etiquetadas que tiene debajo.
Ascender de un nivel a otro
Sección titulada «Ascender de un nivel a otro»El nivel de una afirmación solo cambia con evidencia nueva:
Anécdota → Limitadoal corroborarse de forma independiente (un segundo cultivador, misma técnica).Limitado → Moderadoal confirmarlo un estudio decente o informes prácticos sistemáticos.Moderado → Fuerteal replicarse en condiciones diferentes con resultados consistentes.En conflicto → Fuertesolo cuando se identifica la causa de la diferencia y se mapean las condiciones.Desconocido → Limitadovía un experimento original registrado (experiments/).
Cada ascenso debe ser visible en el historial de git con la fuente añadida.