Ficha 02 · Markdown, Git e tipos especiais

Parte I · Markdown

Exercício 1 · Sintaxe (15 pts)

Escreve em Markdown:

a) Um título de nível 2 com texto "Procedimento".

b) Uma lista numerada com 3 passos.

c) Um link com texto "ver docs" apontando para https://aulify.pt/docs.

d) Uma palavra em negrito dentro de uma frase.

e) Uma tabela com 2 colunas (Comando, Função) e 2 linhas de exemplo.

Exercício 2 · Conversões com Pandoc (10 pts)

Escreve o comando Pandoc para:

a) Converter manual.md em PDF.

b) Converter manual.md em DOCX.

c) Converter manual.md em HTML com CSS personalizado style.css.

Parte II · Git para docs

Exercício 3 · Workflow (15 pts)

Estás a manter documentação num repositório Git partilhado. Descreve o workflow para corrigir um erro num manual:

Exercício 4 · Estrutura de repositório (10 pts)

Propõe uma estrutura para repositório de documentação de uma equipa de IT escolar (15 documentos diferentes: manuais, runbooks, post-mortems, API):

Parte III · Runbook

Exercício 5 · Escrever runbook (20 pts)

Escreve um runbook para reiniciar o servidor Moodle quando os utilizadores reportam lentidão.

Inclui verificações antes e depois, e critérios de rollback se algo correr mal.

Parte IV · Post-mortem

Exercício 6 · Escrever post-mortem (15 pts)

Cenário: ontem (18 Maio 2026) das 14h às 16h o Moodle ficou em baixo. Investigaram e descobriram que um técnico fez UPDATE sem WHERE numa tabela users em produção, alterando 12000 contas. Restauraram do backup das 13h. Perderam-se 1h de trabalho de alunos.

Escreve um post-mortem completo (timeline, causa, lições, acções):