26. Juli, Deworkacy - DocOps von Rostelecom

Hallo!

Wir haben uns entschlossen, hier ein DocOps-Mitap abzuhalten - es ist fast wie bei DevOps, nur was die Dokumentation und alles betrifft, was damit zu tun hat. Es gibt normalerweise nicht viele solcher Ereignisse, es ist verständlich - die Dokumentation ist kein Hype wie beispielsweise React. Und ehrlich gesagt nicht nur reagieren. Böse Sprachen behaupten im Allgemeinen, dass Dokumentation die Sicht beeinträchtigt.



Aber es ist wirklich wichtig, dass die Leute damit arbeiten. Je korrekter und logischer die Prozesse für die Arbeit mit der Dokumentation in Ihrem Unternehmen aufgebaut sind, desto einfacher wird es für alle. Auch an diejenigen Kollegen, deren Arbeit (auf den ersten Blick) nicht in der Dokumentation enthalten ist.

Im Allgemeinen gehen wir am Freitag, dem 26. Juli, um 19.00 Uhr zum Deworkacy (Moskau, Bersenevskaya Naberezhnaya, 6, S. 3) und beginnen zu dokumentieren , über die Dokumentation zu sprechen . Die Liste der Berichte ist unter dem Schnitt.

19.00–19.30 Uhr Nikolay Potashnikov, Kurs-IT-Unternehmen

Pflege der Dokumentation für das Softwareprodukt und dessen Wiederverwendung bei der Berichterstattung an den Kunden
Wir verwenden Asciidoctor seit mehr als zwei Jahren zur Dokumentation in großen benutzerdefinierten Projekten. In dieser Zeit hat sich eine Reihe einfacher Vorgehensweisen angesammelt, mit denen Sie gleichzeitig die Arbeit beschleunigen und die Qualität der empfangenen Dokumente verbessern können. In dem Bericht werde ich die Lösung mehrerer praktischer Probleme bei der Erstellung der Dokumentation in Asciidoctor betrachten, auf die wir in fast jedem Projekt stoßen.


19.30–20.00 Uhr Lana Novikova, Firma Iponweb

Wie wir versucht haben, Sphinx und Confluence zu überqueren
Die Organisation eines Unternehmens-Wikis widerspricht häufig den Docs als Code-Ansatz. Ich werde Ihnen sagen, wie wir versucht haben, sie als Teil eines einzigen Ansatzes miteinander in Einklang zu bringen. Ich werde über die Erfahrungen beim Einrichten der Veröffentlichung von Artefakten der Wissensbasis des UI-Entwicklungsteams durch CI in Confluence als separates Ziel sprechen, das wir im Voraus berücksichtigt haben, ohne zu berücksichtigen, was wir vorhaben und welche Art von "Rechen" wir getroffen haben auf dem Weg.

20.30–21.00 Uhr - Kaffeepause, Networking.

21.00–21.30 Uhr Nikolay Volynkin, Firma Plesk

Schienen unter einem fahrenden Zug ersetzen
Wir ändern das Dokumentationsentwicklungstool in docs-as-code. Dabei:

• Stoppen Sie nicht die Entwicklung und Veröffentlichung,
• Wir erstellen und vergleichen Prototypen mit verschiedenen Werkzeugen.
• Wir übertragen Dokumentationsübersetzungen,
• Korrigieren Sie Fehler und richten Sie den Stil im Quellinhalt aus.
• verzichten Sie auf manuelle Arbeit.

21.30–22.00 Konstantin Valeev, Rostelecom Information Technologies

Dokumentations-Repositorys pflegen
Ich werde Ihnen erklären, wie Sie ein Repository mit Dokumentation verwalten, verschiedene Standardansätze berücksichtigen, die Sie aus der Entwicklung ausleihen können, und einige spezifische Ansätze speziell für die Dokumentation.

22.30–23.00 Uhr freie Kommunikation

Und noch einmal für diejenigen, die gleichzeitig die Ankündigung gelesen und weiter dokumentiert haben.

• Freitag, 26. Juli
• Moskau, Bersenevskaya-Damm, 6, S. 3 (Deworkacy, kleiner Hörsaal)
• 19.00–23.00 Uhr
• Der Eintritt ist frei.
• Link zur Registrierung.