Visión general de la metodología

DIY Agriculture es una base de datos disfrazada de colección de documentos Markdown legibles. Esta página explica cómo encajan las partes y cómo se supone que fluye la información a través del proyecto.

La cadena de información

Pregunta
   ↓
Investigación (docs/methodology/research-methodology.md)
   ↓
Material fuente (research/)        ← notas en bruto, citas, evaluación de calidad
   ↓
Contenido de conocimiento (docs/)  ← páginas narrativas etiquetadas con evidencia
   ↓
Datos estructurados (data/)        ← metadatos de cultivos legibles por máquina
   ↓
Presentación (site/)               ← web Astro/Starlight, herramientas de comparación

El repositorio es la fuente de verdad. La web es una capa de presentación. Nada debería existir solo dentro de la web si razonablemente podría vivir en el repositorio.

Qué va dónde

Ubicación	Contenido	Reglas
docs/methodology/	Cómo investigamos, qué cuenta como evidencia, cómo funcionan unidades y experimentos	Los cambios de metodología son decisiones a nivel de proyecto
docs/crops/<crop>/	Conocimiento narrativo sobre un cultivo, tema por tema	Etiquetado con evidencia; contexto preservado; datos estructurados en sincronía
docs/systems/	Temas transversales: riego, suelo, trillado, secado, almacenamiento…	Las mismas reglas que los cultivos
docs/guides/	Guías prácticas ensambladas a partir de lo anterior	Deben enlazar a la evidencia de la que beben
data/crops/*.yaml	Metadatos estructurados de cultivos para herramientas y comparación	Valores solo a partir de evidencia; si no, null/unknown
research/	Notas de fuentes: artículos, boletines, vídeos, libros	Archivado por tipo de fuente; calidad evaluada; identificadores estables
experiments/	Experimentos originales: protocolos y registros	Basados en plantillas; reproducibles
templates/	Esqueletos reutilizables para cultivos, fuentes y experimentos	La estructura de esta tabla, codificada

Los innegociables

Vienen de los principios del proyecto (PRD.md §6) y se aplican a cada página:

1. Evidencia antes que recomendación. Investiga primero; las recomendaciones emergen de la evidencia, nunca al revés.
2. Preserva la incertidumbre. Desconocido es una respuesta aceptable e incluso preferible.
3. Preserva el desacuerdo. No promedies las diferencias; regístralas con sus condiciones.
4. Preserva el contexto. Las afirmaciones llevan condiciones y fuentes.
5. Relevancia a pequeña escala. Pregunta siempre: ¿qué cambia cuando la agricultura se hace a escala humana?
6. La evidencia científica y la práctica valen ambas, pero se distinguen.
7. Cultivar es solo una parte de la agricultura. La cadena hasta el almacenamiento y el producto utilizable es la unidad de estudio.

Cómo debe verse una afirmación en una página narrativa

Preferible la redacción que preserva el contexto a los números desnudos:

Rendimiento informado: 1.200 kg/ha — Moderado — cultivar X, secano, España, 2019 (S-0117). Un segundo estudio con riego por goteo informó 1.800 kg/ha (S-0119). El desacuerdo se atribuye al régimen de riego.

Componentes mínimos: la afirmación, el nivel de evidencia, contexto suficiente para interpretarla y una referencia de fuente.

Estado de este conjunto de documentos

Estas páginas de metodología son en sí mismas borradores, evolucionarán a medida que se investigue el primer estudio de caso (la chía) y se pruebe el flujo de trabajo en la práctica. Las propuestas de cambio de metodología van en issues/discusiones y, una vez aceptadas, en PRD.md.