26 Juli, Deworkacy - DocOps dari Rostelecom

Hai

Kami memutuskan untuk mengadakan mitap DocOps di sini - hampir seperti DevOps, hanya tentang dokumentasi dan segala sesuatu yang berkaitan dengannya. Biasanya tidak banyak acara seperti itu, bisa dimengerti - dokumentasi bukan hal yang hype seperti Bereaksi, misalnya. Dan bukan hanya Bereaksi, terus terang. Bahasa-bahasa jahat umumnya mengklaim bahwa dokumentasi merusak visi.



Tetapi itu sangat penting, orang-orang bekerja dengannya, dan semakin tepat dan logis di perusahaan Anda proses kerja dengan dokumentasi dibangun, semakin mudah bagi semua orang. Bahkan untuk rekan-rekan yang pekerjaannya (sekilas) tidak terhubung dalam dokumentasi.

Secara umum, pada hari Jumat, 26 Juli, pukul 19.00 kita akan pergi ke Deworkacy (Moskow, Bersenevskaya Naberezhnaya, 6, hal. 3) dan mulai mendokumentasikan pembicaraan tentang dokumentasi . Daftar laporan berada di bawah potongan.

19.00–19.30 Nikolay Potashnikov, perusahaan Kurs-IT

Menyimpan dokumentasi untuk produk perangkat lunak dan penggunaannya kembali dalam pelaporan kepada pelanggan
Kami telah menggunakan Asciidoctor untuk dokumentasi dalam proyek kustom besar selama lebih dari dua tahun. Selama waktu ini, serangkaian praktik sederhana telah terakumulasi yang memungkinkan Anda untuk secara bersamaan mempercepat pekerjaan dan meningkatkan kualitas dokumen yang diterima. Dalam laporan tersebut, saya akan mempertimbangkan solusi dari beberapa masalah praktis dalam persiapan dokumentasi di Asciidoctor, yang kami temui di hampir setiap proyek.


19.30–20.00 Lana Novikova, perusahaan Iponweb

Bagaimana kami mencoba melintasi Sphinx dan Confluence
Organisasi wiki perusahaan sering menentang Dokumen sebagai pendekatan kode. Saya akan memberi tahu Anda bagaimana kami mencoba mendamaikan mereka sebagai bagian dari pendekatan tunggal, saya akan berbicara tentang pengalaman menyiapkan publikasi artefak dari basis pengetahuan tim pengembangan UI melalui CI dalam Confluence sebagai target terpisah, yang kami perhitungkan sebelumnya, tidak memperhitungkan apa yang kami rencanakan untuk dilakukan dan apa yang kami rencanakan untuk lakukan. di jalan.

20.30–21.00 - rehat kopi, berjejaring.

21.00–21.30 Nikolay Volynkin, perusahaan Plesk

Mengganti rel di bawah kereta bepergian
Kami mengubah alat pengembangan dokumentasi menjadi docs-as-code. Dalam hal ini:

  • jangan berhenti pengembangan dan publikasi,
  • kami membuat dan membandingkan prototipe pada beberapa alat,
  • Kami mentransfer terjemahan dokumentasi,
  • memperbaiki kesalahan dan menyelaraskan gaya dalam konten sumber,
  • lakukan tanpa kerja manual.


21.30–22.00 Konstantin Valeev, Rostelecom Teknologi Informasi

Menjaga repositori dokumentasi
Saya akan memberi tahu Anda cara mempertahankan repositori dengan dokumentasi, pertimbangkan beberapa pendekatan standar yang dapat Anda pinjam dari pengembangan, dan beberapa pendekatan khusus untuk dokumentasi.

22.30–23.00 komunikasi gratis

Dan sekali lagi bagi mereka yang secara bersamaan membaca pengumuman dan terus mendokumentasikan.

  • 26 Juli, Jumat
  • Moskow, tanggul Bersenevskaya, 6, hal. 3 (Deworkacy, ruang kuliah kecil)
  • 19.00–23.00
  • Penerimaan gratis.
  • Tautan ke pendaftaran.

Source: https://habr.com/ru/post/id460899/


All Articles