Combina R y Python para crear documentación espectacular

En la ejecución de proyectos de ixpantia ponemos énfasis en acompañar entregables con buena documentación. Como mínimo dejamos una documentación técnica en los wiki que acompañan nuestro código y con un resumen enfocados en usuarios en los README (archivo LEEME) en cada repositorio. Pero hay proyectos donde la documentación en un un proyecto en sí que tiene como grupo meta más usuarios que los equipos técnicos que están cerca al código. Por sus características estas documentación tiene que ser más larga y compleja y contener múltiples capítulos con contenido diverso. En nuestra experiencia esta documentación tiene que cumplir con las siguientes características. 1) Tener un excelente sistema para poder hacer búsquedas. 2) Es fácil de desplegar para dar acceso a una gran cantidad de usuarios. 3) Poder escribir en un formato texto para poder aplicar mejores prácticas de devops/dataops.

En este webinario presentamos como en nuestro dia a dia combinamos Rmarkdown y MkDocs para generar documentación que cumple con estos requisitos. A pesar de que MkDocs está escrito en Python, podemos utilizarlo con Rmarkdown para incluir cualquier tipo de código (R, SQL, Python, etc.) y desplegar el resultado a cualquier servidor web, o a un servicio de despliegue de productos de datos como RStudio Connect.

La charla la imparte Frans van Dunné, Chief Data Officer de ixpantia. Frans combina un conjunto de habilidades diversas, incluyendo análisis de negocio, análisis de datos y arquitectura empresarial, con más de 15 años de experiencia en análisis e innovación con datos. Cuenta con un doctorado de la Universidad de Amsterdam y ha enseñado en diversas universidades. Como consultor ha trabajado con empresas alrededor del mundo en diversos temas, incluyendo innovación basada en datos, estadísticas aplicadas, programación estadística y aprendizaje de máquinas.