Início Documentação no InfoQ Brasil
Artigos
Feed RSS-
/articles/book-review-living-documentation/pt/smallimage/livinig-documentation-cover-s-1568792232451.jpg)
Perguntas e respostas com Cyrille Martraire sobre o livro Living Documentation
Cyrille Martraire discute a necessidade de repensar como trabalhamos com a documentação quando criamos sistemas de software. Deveríamos adotar uma documentação que evolui no mesmo ritmo que o código. Neste livro, descreve conceitos e ideias que formam a base para a documentação viva e usa exemplos práticos de como criar uma documentação que está sempre atualizada.
-
/articles/openapi/pt/smallimage/open-api-s-1560967631428.jpeg)
Usando a OpenAPI para criar APIs inteligentes que ajudam os desenvolvedores
Este artigo descreve como criar, gerenciar, e manter APIs com a OpenAPI, incluindo alguns dos recursos mais notáveis da versão 3.0.
-
/articles/why-architectural-diagrams/pt/smallimage/why-architectural-diagrams-s-1547639074677.jpeg)
Por que precisamos de diagramas de arquitetura?
Os diagramas de arquitetura de software, quando bem criados e com moderação, podem melhorar significativamente a comunicação dentro da equipe de desenvolvimento e com as partes interessadas externas. Eles exigem uma compreensão do público-alvo e uma restrição cuidadosa sobre o que incluir. Resista à tentação de pensar que os diagramas são desnecessários ou inúteis, devido a experiências ruins.
-
/articles/de-use-cases-para-user-stories/pt/smallimage/1-CI5POtW3bUqJdFOJpKkp6g100x100.jpg)
De Use Cases para User Stories: dicas e desafios na transição
Muitas dúvidas podem surgir durante a transição para utilizar histórias de usuário em vez de casos de uso. Veja neste artigo, com base em uma experiência real de transição, alguns desafios enfrentados e dicas de como proceder.