La historia detrás del nuevo sitio de documentación de 4D basado en Markdown

Traducido automáticamente de Deepl

por Arnaud Schmitt, Director de Documentación Técnica de 4D SAS

Como muchos de ustedes saben, doc.4d.com ha sido administrado durante mucho tiempo utilizando una aplicación interna de 4D. Sin embargo, la documentación de 4D está actualmente en transición hacia una nueva arquitectura: un sitio de documentación basado en Markdown.

Este fue el tema hace unas semanas durante una reunión del Método 4D, donde compartí nuestra experiencia sobre la creación y el mantenimiento del nuevo sitio de documentación. Puede encontrar esta información útil cuando navegue por el sitio de documentación de 4D, o si necesita crear su propia documentación.

¿Por qué un nuevo sitio de documentación?

Bueno, el anterior sitio de documentación de 4D sigue vivo y es muy útil, pero está anticuado y tiende a ser difícil de evolucionar debido al código antiguo. Así que lo que queríamos es

  • un nuevo diseño para las nuevas tecnologías,
  • una forma de documentar la API con clases, herencia, jerarquía, etc.
  • para tener más control sobre los formatos, estilos, construcciones, etc.

En este video, explico en detalle las razones detrás de esta transición, la arquitectura general, y mucho más:

No dude en unirse a mí en el Foro 4D si tiene alguna pregunta.

¿Qué es 4DMethod?

El grupo4DMethod es un grupo de usuarios de 4D organizado por Brent Raymond.

El grupo organiza reuniones periódicas para proporcionar una comunidad tanto a los usuarios como a los desarrolladores de 4D, discutir problemas técnicos con los sistemas actuales e ideas para el desarrollo futuro, ofrecer soluciones de codificación a los desarrolladores nuevos y experimentados, por nombrar algunos.

Conozca más sobre el método 4D aquí.

Arnaud Schmitt
Después de obtener una maestría en Comunicación y Marketing en la Universidad de la Sorbona de París, Arnaud comenzó su carrera en la industria de los medios de comunicación como periodista y secretario de redacción.Apasionado por la informática, se unió a la empresa ACI (que luego se convirtió en 4D) a principios de los años 90 como escritor técnico. Continuando la aventura de 4D, Arnaud ha asumido desde entonces la dirección del departamento de Documentación. A lo largo de los años, ha apoyado tanto las evoluciones del producto 4D como las de las herramientas de documentación, desde FrameMaker hasta Docusaurus, pasando por Doc Center.