Diataxis Framework
The Diataxis Framework is a great example of the kind of practical and theoretical approach to creating documentation that I’ve been looking for. It provides confident and opinionated guidelines for distinguishing between different types of documentation content, explains their purpose, and provides recommendations for how each should be written. Surprisingly the author recommends against using this system as part of any comprehensive strategic documentation plan but rather as a kind of thoughtful daily gardening practice in which the whole takes shape by applying the same consistent approach to each smaller part at every stage. “Be like frog.” That’s deep.
Diataxis Framework
El Diataxis framework es un buen ejemplo del tipo de aproximación práctica y teórica para la creación de documentación que he estado buscando. Con mucha seguridad ofrece unas pautas bastante opinionadas sobre como distinguir entre los diferentes tipos de contenido para la documentación, explica su finalidad y ofrece recomendaciones sobre cómo debe redactarse cada uno de ellos. Sorprendentemente, el autor recomienda no utilizar este sistema como parte de un plan de documentación estratégico integral, sino como una especie de práctica de jardinería meditativa cotidiana en la que el conjunto toma forma aplicando el mismo enfoque coherente a cada parte más pequeña en cada etapa. “Se como rana.” Que profundo.