26 juillet, Deworkacy - DocOps de Rostelecom

Salut

Nous avons décidé de tenir un mitap DocOps ici - c'est presque comme DevOps, seulement sur la documentation et tout ce qui s'y rapporte. Il n'y a généralement pas beaucoup d'événements de ce type, c'est compréhensible - la documentation n'est pas un battage médiatique comme React, par exemple. Et pas seulement React, franchement. Les mauvaises langues prétendent généralement que la documentation gâche la vision.



Mais c'est vraiment important, les gens travaillent avec, et plus les processus de travail avec la documentation sont construits correctement et logiquement dans votre entreprise, plus cela sera facile pour tout le monde. Même aux collègues dont le travail (à première vue) n'est pas lié à la documentation.

En général, le vendredi 26 juillet, à 19 heures, nous allons à Deworkacy (Moscou, Bersenevskaya Naberezhnaya, 6, p. 3) et nous commençons à documenter et à parler de documentation . La liste des rapports est sous la coupe.

19.00–19.30 Nikolay Potashnikov, société Kurs-IT

Gestion de la documentation du produit logiciel et de sa réutilisation dans les rapports au client
Nous utilisons Asciidoctor pour la documentation de grands projets personnalisés depuis plus de deux ans. Pendant ce temps, un ensemble de pratiques simples s'est accumulé qui vous permet d'accélérer simultanément le travail et d'améliorer la qualité des documents reçus. Dans le rapport, j'examinerai la solution de plusieurs problèmes pratiques dans la préparation de la documentation dans Asciidoctor, que nous rencontrons dans presque tous les projets.


19 h 30-20 h 00 Lana Novikova, société Iponweb

Comment nous avons essayé de traverser Sphinx et Confluence
L'organisation d'un wiki d'entreprise est souvent opposée aux Docs en tant qu'approche de code. Je vais vous dire comment nous avons essayé de les concilier dans le cadre d'une approche unique, je vais parler de l'expérience de la mise en place de la publication des artefacts de la base de connaissances de l'équipe de développement de l'interface utilisateur via CI dans Confluence en tant qu'objectif distinct, que nous avons pris en compte à l'avance, n'a pas pris en compte ce que nous prévoyons de faire et quel type de «râteau» nous avons rencontré en route.

20h30 - 21h00 - pause café, réseautage.

21h00 - 21h30 Nikolay Volynkin, société Plesk

Remplacement des rails sous un train roulant
Nous changeons l'outil de développement de documentation en docs-as-code. Dans ce cas:

• n'arrêtez pas le développement et la publication,
• nous réalisons et comparons des prototypes sur plusieurs outils,
• Nous transférons les traductions de documentation,
• corriger les erreurs et aligner le style dans le contenu source,
• faire sans travail manuel.

21h30 - 22h00 Konstantin Valeev, Rostelecom Technologies de l'information

Maintenance des référentiels de documentation
Je vais vous expliquer comment gérer un référentiel avec de la documentation, envisager plusieurs approches standard que vous pouvez emprunter au développement, et quelques approches spécifiques spécifiquement pour la documentation.

22h30-23h00 communication gratuite

Et encore une fois pour ceux qui ont simultanément lu l'annonce et continué à documenter.

• 26 juillet, vendredi
• Moscou, remblai Bersenevskaya, 6, p. 3 (Deworkacy, small lecture hall)
• 19h00-23h00
• L'entrée est gratuite.
• Lien vers l'inscription.