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

[Roque Gagliano]

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
------------ próxima parte ------------
Se ha borrado un adjunto en formato HTML...
URL: <https://mail.lacnic.net/pipermail/lacnog/attachments/20221012/9f8049e4/attachment.htm>