<div dir="ltr"><div class="gmail_default" style="font-family:monospace,monospace">Felicitaciones por el draft.</div><div class="gmail_default" style="font-family:monospace,monospace"><br></div><div class="gmail_default" style="font-family:monospace,monospace">Hasta hace poco estuvimos usando BookStack <a href="https://www.bookstackapp.com/">https://www.bookstackapp.com/</a> para documentación interna. También está basada en Markdown.</div><div class="gmail_default" style="font-family:monospace,monospace">El único motivo que nos salimos de esa aplicación fue que tenemos otra que se integra mejor con los proyectos.</div><div class="gmail_default" style="font-family:monospace,monospace"><br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, Oct 12, 2022 at 4:23 PM Roque Gagliano <<a href="mailto:rgaglian@gmail.com">rgaglian@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div>Hola lista,</div><div><br></div><div>Acabo de terminar mi primer IETF draft en 5 años. Lo escribí sobre un área naciente que es el encuentro entre OpenTelemetry (<a href="https://opentelemetry.io/" target="_blank">https://opentelemetry.io/</a>) y protocolos de gestión de red como NETCONF y RESTCONF.</div><div><br></div><div>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 (<a href="https://authors.ietf.org/en/choosing-a-format-and-tools" target="_blank">https://authors.ietf.org/en/choosing-a-format-and-tools</a>) 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.<br></div><div><br></div><div>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: <a href="https://github.com/cabo/kramdown-rfc/wiki/Syntax" target="_blank">https://github.com/cabo/kramdown-rfc/wiki/Syntax</a></div><div><br></div><div>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 (<a href="https://github.com/martinthomson/internet-draft-template" target="_blank">https://github.com/martinthomson/internet-draft-template</a>.) Lo usaré en breve.<br></div><div><br></div><div>Para los que quieran leer sobre OpenTelemetría, NETCONF y RESTCONF aquí el link del draft: <a href="https://www.ietf.org/archive/id/draft-rogaglia-netconf-trace-ctx-extension-00.html" target="_blank">https://www.ietf.org/archive/id/draft-rogaglia-netconf-trace-ctx-extension-00.html</a></div><div><br></div><div>Espero que esto ayude a otros u otros a contar sus experiencias.<br></div><div><br></div><div>Saludos cordiales,</div><div>Roque<br></div><div><div><br>-- <br><div dir="ltr"><br><br>At least I did something<br>Don Draper - Mad Men</div></div></div></div>
_______________________________________________<br>
LACNOG mailing list<br>
<a href="mailto:LACNOG@lacnic.net" target="_blank">LACNOG@lacnic.net</a><br>
<a href="https://mail.lacnic.net/mailman/listinfo/lacnog" rel="noreferrer" target="_blank">https://mail.lacnic.net/mailman/listinfo/lacnog</a><br>
Cancelar suscripcion: <a href="https://mail.lacnic.net/mailman/options/lacnog" rel="noreferrer" target="_blank">https://mail.lacnic.net/mailman/options/lacnog</a><br>
</blockquote></div>