Exercícios — Módulo IX — Documentação técnica de implantação

✏️ Fixação rápida

Individual — responda por escrito

1. Qual a diferença entre documentação técnica e manual do usuário? Dê um exemplo de informação que vai na documentação técnica mas nunca no manual do usuário.

2. Para cada informação abaixo, indique em qual documento ela deve ser registrada: (Registro de instalação / Ata de treinamento / Ata de encerramento / Manual do usuário)

Informação	Documento
Versão do Node.js instalada
Lista de funcionalidades aprovadas pelo cliente
Passo a passo para cadastrar um sócio
Dúvida levantada pela Cláudia durante o treinamento
Pendência com prazo acordado de 30 dias
Porta utilizada pela aplicação em produção
Assinatura do cliente confirmando o aceite

3. Por que documentar em tempo real é mais confiável do que documentar depois?

4. Verdadeiro ou falso — justifique as falsas:

( ) Se a implantação correu sem nenhum problema, não é necessário preencher o registro de instalação.
( ) Decisões tomadas durante a implantação e seus motivos devem ser documentadas.
( ) A ata de encerramento protege apenas o cliente em caso de disputas futuras.
( ) Um técnico experiente não precisa de documentação porque guarda tudo na memória.

5. Leia o registro de instalação incompleto abaixo e identifique pelo menos 5 informações que estão faltando:

REGISTRO DE INSTALAÇÃO
Sistema  : Chapecoense
Data     : 15/03/2024
Técnico  : João

Passos executados:
[X] Instalação concluída
[X] Sistema funcionando

Assinatura: João

6. Um técnico foi chamado para dar suporte ao sistema da Chapecoense 6 meses após a implantação. O técnico original não deixou nenhuma documentação. Liste pelo menos 5 perguntas que o novo técnico teria dificuldade de responder sem o registro de instalação.

7. Qual a diferença entre uma pendência bloqueante e uma pendência não bloqueante no contexto da ata de encerramento? Como cada uma deve ser registrada?

8. Verdadeiro ou falso — justifique as falsas:

( ) A ata de treinamento é desnecessária se todos os usuários aprenderam bem.
( ) O registro de instalação deve incluir não apenas o que funcionou, mas também os problemas encontrados e como foram resolvidos.
( ) A documentação técnica pertence ao técnico que a escreveu — não ao cliente.
( ) Uma ata de encerramento assinada encerra formalmente qualquer responsabilidade do técnico sobre o sistema.
( ) "Onde encontrar cada configuração" é uma informação tão importante quanto as versões dos softwares instalados.

🏆 Desafio final — Portfólio de implantação

Individual — tempo sugerido: 60 minutos

📋 Entregável: os três documentos de encerramento preenchidos 🏆 Este exercício compõe o portfólio final da disciplina

Usando os templates disponíveis na base de conhecimento e tudo o que foi feito ao longo dos módulos anteriores, preencha os três documentos de encerramento da implantação da Chapecoense.

Documento 1 — Registro de instalação Preencha com base no que você fez no exercício do Módulo IV.

Documento 2 — Ata de treinamento Preencha com base no roleplay do Módulo VI.