[lacnog] Escribiendo mi primer draft luego de 5 años

[Tomas Lynch]

Felicitaciones por el draft.

Hasta hace poco estuvimos usando BookStack https://www.bookstackapp.com/
para documentación interna. También está basada en Markdown.
El único motivo que nos salimos de esa aplicación fue que tenemos otra que
se integra mejor con los proyectos.


On Wed, Oct 12, 2022 at 4:23 PM Roque Gagliano <rgaglian en gmail.com> wrote:

> Hola lista,
>
> Acabo de terminar mi primer IETF draft en 5 años. Lo escribí sobre un área
> naciente que es el encuentro entre OpenTelemetry (
> https://opentelemetry.io/) y protocolos de gestión de red como NETCONF y
> RESTCONF.
>
> Luego de 5 años sin escribir, me llevó un tiempo buscar qué herramienta es
> la mejor para usar hoy en día. La verdad que el sitio del IETF (
> https://authors.ietf.org/en/choosing-a-format-and-tools) no fue de gran
> ayuda pues me tiraba hacia aplicaciones de edición XML. Yo tenía
> experiencia con XMLmind pero el plugin está sin mantenimiento y realmente
> pasé mucho tiempo para nada. Creo que si bien se puede contribuir, hay una
> dificultad para tener las mejores prácticas.
>
> Me dí por vencido y le pregunté a un colega qué usaba. Descubrí que la
> nueva tendencia para escribir drafts IETF es utilizando Markdown (no estaba
> disponible en el pasado) y la verdad que la experiencia fue super positiva.
> Si bien en el sitio del IETF dice de no haber soporte "oficial", para mí no
> hay vuelta atrás. Si alguien piensa en escribir algún documento por la
> primera vez y quiere buscar cómo, les paso el link:
> https://github.com/cabo/kramdown-rfc/wiki/Syntax
>
> Luego creé mi propio ambiente y cadena de compilado, pero al parecer ya
> hay cosas hechas, pero de vuelta la documentación no ayuda y al parecer
> perdí el tiempo. En especial, parece que lo más usado es el template de
> Martin Thomson (https://github.com/martinthomson/internet-draft-template.)
> Lo usaré en breve.
>
> Para los que quieran leer sobre OpenTelemetría, NETCONF y RESTCONF aquí el
> link del draft:
> https://www.ietf.org/archive/id/draft-rogaglia-netconf-trace-ctx-extension-00.html
>
> Espero que esto ayude a otros u otros a contar sus experiencias.
>
> Saludos cordiales,
> Roque
>
> --
>
>
> At least I did something
> Don Draper - Mad Men
> _______________________________________________
> LACNOG mailing list
> LACNOG en lacnic.net
> https://mail.lacnic.net/mailman/listinfo/lacnog
> Cancelar suscripcion: https://mail.lacnic.net/mailman/options/lacnog
>
------------ próxima parte ------------
Se ha borrado un adjunto en formato HTML...
URL: <https://mail.lacnic.net/pipermail/lacnog/attachments/20221013/57cf3c3f/attachment.htm>