Oi
Decidimos realizar uma mitap de DocOps aqui - é quase como o DevOps, apenas sobre a documentação e tudo relacionado a ela. Geralmente, não há muitos eventos desse tipo, é compreensível - a documentação não é tão exagerada como o React, por exemplo. E não apenas reagir, francamente. As línguas más geralmente afirmam que a documentação estraga a visão.
Mas é realmente importante, as pessoas trabalham com ele e, quanto mais correto e logicamente em sua empresa forem os processos de trabalhar com a documentação, mais fácil será para todos. Mesmo para os colegas cujo trabalho (à primeira vista) não está conectado na documentação.
Em geral, na sexta-feira, 26 de julho, às 19h00, vamos ao Deworkacy (Moscou, Bersenevskaya Naberezhnaya, 6, p. 3) e começamos a
documentar e conversar sobre documentação . A lista de relatórios está sob o corte.
19.00–19.30 Nikolay Potashnikov, empresa Kurs-ITManter a documentação do produto de software e sua reutilização nos relatórios ao clienteEstamos usando o Asciidoctor para documentação em grandes projetos personalizados há mais de dois anos. Durante esse período, acumulou-se um conjunto de práticas simples que permitem acelerar o trabalho simultaneamente e melhorar a qualidade dos documentos recebidos. No relatório, considerarei a solução de vários problemas práticos na preparação da documentação no Asciidoctor, que encontramos em quase todos os projetos.
19h30-20h00 Lana Novikova, empresa da IponwebComo tentamos atravessar Esfinge e ConfluênciaA organização de um wiki corporativo geralmente se opõe ao Docs como abordagem de código. Vou contar como tentamos reconciliá-los como parte de uma única abordagem. Vou contar sobre a experiência de configurar a publicação de artefatos da base de conhecimento da equipe de desenvolvimento da interface do usuário por meio do CI no Confluence como um alvo separado, que levamos em conta com antecedência, que não levamos em conta o que planejamos fazer e que tipo de "rake" encontramos. a caminho.
20.30–21.00 - coffee break, networking.
21.00–21.30 Nikolay Volynkin, empresa PleskSubstituição de trilhos sob um trem de viagemAlteramos a ferramenta de desenvolvimento de documentação para docs-code. Nesse caso:
- não pare o desenvolvimento e publicação,
- fazemos e comparamos protótipos em várias ferramentas,
- Transferimos traduções de documentação,
- corrija erros e alinhe o estilo no conteúdo de origem,
- fazer sem trabalho manual.
21h30–22h00 Konstantin Valeev, Rostelecom Information TechnologiesManutenção de repositórios de documentaçãoVou explicar como manter um repositório com documentação, considerar várias abordagens padrão que você pode emprestar do desenvolvimento e algumas específicas para a documentação.
22,30–23,00 comunicação gratuitaE mais uma vez para quem leu simultaneamente o anúncio e continuou a documentar.
- 26 de julho, sexta-feira
- Moscou, aterro de Bersenevskaya, 6, página 3 (Deworkacy, pequena sala de aula)
- 19,00–23,00
- A entrada é gratuita.
- Link para registro.