Hola
Decidimos mantener un mitap de DocOps aquí: es casi como DevOps, solo se trata de la documentación y todo lo relacionado con ella. Por lo general, no hay muchos eventos de este tipo, es comprensible: la documentación no es tan exagerada como React, por ejemplo. Y no solo Reaccionar, francamente. Los lenguajes malvados generalmente afirman que la documentación arruina la visión.
Pero es realmente importante, las personas trabajan con él, y cuanto más correctamente y más lógicamente en su empresa se construyan los procesos de trabajo con la documentación, más fácil será para todos. Incluso a aquellos colegas cuyo trabajo (a primera vista) no está conectado en la documentación.
En general, el viernes 26 de julio a las 19.00 iremos a Deworkacy (Moscú, Bersenevskaya Naberezhnaya, 6, p. 3) y comenzaremos a
documentar sobre la documentación . La lista de informes está debajo del corte.
19.00–19.30 Nikolay Potashnikov, empresa de Kurs-ITMantener la documentación del producto de software y su reutilización para informar al cliente.Hemos estado usando Asciidoctor para la documentación en grandes proyectos personalizados durante más de dos años. Durante este tiempo, se ha acumulado un conjunto de prácticas simples que le permiten acelerar simultáneamente el trabajo y mejorar la calidad de los documentos recibidos. En el informe, consideraré la solución de varios problemas prácticos en la preparación de la documentación en Asciidoctor, que encontramos en casi todos los proyectos.
19.30–20.00 Lana Novikova, compañía IponwebCómo intentamos cruzar Sphinx y ConfluenceLa organización de una wiki corporativa a menudo se opone a los Documentos como enfoque de código. Te diré cómo tratamos de conciliarlos en el marco de un enfoque único, te contaré sobre la experiencia de configurar la publicación de artefactos de la base de conocimiento del equipo de desarrollo de UI a través de CI en Confluence como un objetivo separado, que tomamos en cuenta de antemano, no tomamos en cuenta lo que planeamos hacer y qué tipo de "rastrillo" conocimos en el camino
20.30–21.00 - pausa para el café, trabajo en red.
21.00–21.30 Nikolay Volynkin, empresa PleskSustitución de rieles debajo de un tren que viajaCambiamos la herramienta de desarrollo de documentación a docs-as-code. En este caso:
- no detengas el desarrollo y la publicación,
- creamos y comparamos prototipos en varias herramientas,
- Transferimos traducciones de documentación,
- corregir errores y alinear el estilo en el contenido de origen,
- prescindir del trabajo manual.
21.30–22.00 Konstantin Valeev, Rostelecom Tecnologías de la informaciónMantenimiento de repositorios de documentaciónLe diré cómo mantener un repositorio con documentación, considere varios enfoques estándar que puede tomar prestados del desarrollo y algunos específicos para la documentación.
22.30–23.00 comunicación gratuitaY una vez más para aquellos que leyeron simultáneamente el anuncio y continuaron documentando.
- 26 de julio, viernes
- Moscú, terraplén Bersenevskaya, 6, p. 3 (Deworkacy, pequeña sala de conferencias)
- 19.00–23.00
- La entrada es gratuita.
- Enlace al registro.