📦 SMP/E for z/OS – SYSMOD Packaging

Bellacosa Mainframe apresenta smp/e sysmod packaging

📦 SMP/E for z/OS – SYSMOD Packaging

Entendendo MCS e técnicas de empacotamento sem dor de cabeça

---

🧠 Ideia central (em uma frase)

SYSMOD = conteúdo + instruções (MCS)
O como, onde e quando instalar é decidido pelas MCS.

---

🧩 O que existe dentro de um SYSMOD?

Todo SYSMOD tem duas coisas:

1. Texto de modificação

   • módulos

   • macros

   • source

   • dados

   • HFS / JAR

2. MCS – Modification Control Statements

   • instruções para o SMP/E

   • dizem onde, quando e em que ordem instalar

📌 Durante o RECEIVE, o SMP/E:

• lê primeiro as MCS

• grava tudo no SMPPTS

• cada SYSMOD vira uma MCS entry

---

🧱 Tipos de elementos em DLIB / TLIB

Tipo	O que é
Module	Código compilado/ligado
Macro	Fonte reutilizável
Source	Código fonte
Data	CLIST, PARM, PROC etc
HFS	Arquivos Unix
JAR	Java Archive

---

🧾 Regras básicas das MCS (cai em prova)

• Todas começam com ++

• Colunas 1–2 → ++

• Terminam com ponto (.)

• Podem continuar linha se não houver ponto antes da coluna 73

• Colunas 73–80 são ignoradas

---

🪪 HEADER e identificação do SYSMOD

++HEADER

• identifica o tipo do SYSMOD

• define o SYSMOD-ID

Tipos de SYSMOD

Tipo	Para quê
FUNCTION	Introduz produto
PTF	Correção testada
APAR	Correção de problema
USERMOD	Correção local

---

🧬 FMID — quem “é dono” do código

• FMID = Function Modification ID

• 7 caracteres

• identifica a função dona do elemento

• em FUNCTION, o FMID é o próprio SYSMOD-ID

📌 Todo SYSMOD exceto base FUNCTION usa FMID no ++VER.

---

🔗 ++VER — relacionamento e dependências

O ++VER é o cérebro da compatibilidade

Regras:

• Obrigatório

• Deve vir logo após o HEADER

• Define:

  • release suportado (SREL)

  • dependências

  • pré-requisitos

  • co-requisitos

  • supersedes

Operandos importantes

Operando	Função
SREL	Release do sistema
FMID	Função dona
PRE	Pré-requisito
REQ	Co-requisito
SUP	Supersede

---

🚦 ++HOLD — bloqueios controlados

Existem 3 tipos:

Tipo	Quando usar
ERROR	PTF com erro
SYSTEM	Ação manual necessária
USER	Regra local

📌 HOLD impede APPLY/ACCEPT até ser resolvido
📌 Pode vir no SYSMOD ou em HOLDDATA separado

---

🏗️ MCS estruturais – como o sistema é montado

++JCLIN

• descreve como o load module é ligado

• não executa, apenas é analisado

• grava estrutura no TZONE

Sem JCLIN → SMP/E não sabe reconstruir load modules.

---

🧩 MCS de elemento (o que será instalado)

MCS	O que instala
++MOD	Módulo
++SRC	Source
++MAC	Macro
++DATA	Dados
++HFS	Arquivo Unix
++JAR	JAR inteiro
++ZAP	Patch binário
++SRCUPD	Update de source
++MACUPD	Update de macro
++JARUPD	Update parcial de JAR

📌 ZAP / UPD = alteração parcial
📌 DATA / HFS = sempre substituição total

---

☕ JAR no SMP/E (pegadinha comum)

• ++JAR → substitui o JAR inteiro

• ++JARUPD → atualiza arquivos internos

• SMP/E usa comandos do JDK (jar x / jar u)

---

📦 Técnicas de empacotamento SYSMOD

Como o conteúdo chega até o SMP/E

1️⃣ Relative File (tape)

📼 Clássico IBM

• MCS em um arquivo

• elementos em arquivos seguintes

• usa RELFILE

✔️ Muito usado em FUNCTION SYSMOD

---

2️⃣ Inline

📄 Tudo junto

• MCS + conteúdo no mesmo arquivo

• registros fixos de 80 bytes

• simples, direto

⚠️ Dados variáveis precisam de GIMDTS

---

3️⃣ Indirect Library

📚 USERMOD raiz

• MCS no SMPPTS

• conteúdo fica fora (PDS indicado no APPLY)

• usa TXLIB, LKLIB

✔️ Ideal para USERMOD

---

4️⃣ GIMZIP Archive

🌐 Moderno / rede

• arquivo compactado no HFS

• inclui:

  • MCS

  • elementos

  • HOLDDATA

• usa:

  • GIMZIP

  • GIMUNZIP

  • RECEIVE FROMNETWORK

✔️ Base do Shopz / Internet delivery

---

❌ “What’s wrong with this picture?” (clássico de prova)

Erros comuns:

1. ++MOD não é o último MCS

2. Inline com RELFILE

3. FMID ausente

4. Falta ponto final

5. SREL inválido (2038 ≠ Z038)

---

🧠 Resumo final (para memorizar)

🔑 RECEIVE lê MCS
🔑 APPLY instala no target
🔑 ACCEPT congela no DLIB
🔑 ++VER controla dependências
🔑 JCLIN explica como montar
🔑 Packaging define onde está o conteúdo

 

 

Bellacosa Mainframe apresenta MVS Commands

🖥️ MVS Console Commands – Principais Comandos

⚠️ Aviso importante
A maioria desses comandos exige privilégio de operador (OPERCMDS, OPERATIONS, etc.).
Em ambiente restritivo, eles são substituídos por SDSF.

---

🔍 1️⃣ Comandos de Display (D)

Usados para consulta (os mais comuns e mais seguros).

🔹 D A,L – Displays Active Jobs

D A,L

📌 Mostra jobs ativos no sistema
🧠 Base de automação e monitoramento

---

🔹 D R,L – Displays Outstanding Replies

D R,L

📌 Mostra WTORs pendentes
💬 Operação vive aqui

---

🔹 D U,ALL – Displays Users

D U,ALL

📌 Usuários logados
⚠️ Pode ser restrito por segurança

---

🔹 D IPLINFO

D IPLINFO

📌 Data/hora do último IPL
🧠 Muito usado em troubleshooting

---

🔹 D OMVS

D OMVS

📌 Status do UNIX System Services (USS)

---

🔹 D XCF,STRUCTURE

D XCF,STRUCTURE

📌 Estruturas de sysplex
🧠 Ambiente Parallel Sysplex

---

▶️ 2️⃣ Comandos de Job Control ($ – JES2)

🔹 $D JOBS

$D JOBS

📌 Lista jobs no spool

---

🔹 $DA jobname

$DA PAYROLL

📌 Detalhe de um job específico

---

🔹 $C jobname

$C PAYROLL

📌 Cancela job
⚠️ Perigoso – exige autoridade

---

🔹 $P jobname

$P PAYROLL

📌 Pausa job

---

🔹 $A jobname

$A PAYROLL

📌 Libera job pausado

---

🔄 3️⃣ Comandos de Sistema (F, S, P)

🔹 S procname

S TCPIP

📌 Inicia started task

---

🔹 P procname

P TCPIP

📌 Para started task
⚠️ Impacto alto

---

🔹 F procname,command

F JES2,STATUS

📌 Envia comando para STC

🧠 Muito usado para CICS, DB2, MQ.

---

🧠 4️⃣ Comandos de Memória / Performance

🔹 D ASM

D ASM

📌 Status de memória auxiliar

---

🔹 D REAL

D REAL

📌 Memória real

---

🔹 D VIRT

D VIRT`

📌 Memória virtual

---

🔹 D IOS

D IOS

📌 Subsystem de I/O

---

🌐 5️⃣ Rede / Comunicação

🔹 D NET,ID=

D NET,ID=VTAM

📌 Status VTAM

---

🔹 D TCPIP

D TCPIP

📌 Status da pilha TCP/IP

---

🧾 6️⃣ Storage, Datasets e Devices

🔹 D U,DASD

D U,DASD

📌 DASDs online/offline

---

🔹 VARY ONLINE

VARY 1234,ONLINE

📌 Ativa device
⚠️ Altíssimo impacto

---

🔹 VARY OFFLINE

VARY 1234,OFFLINE

📌 Desativa device

---

🧯 7️⃣ Comandos de Emergência (raros)

🔹 CANCEL

CANCEL jobname

🔹 RESET

RESET`

⚠️ Normalmente restritos a operadores sênior.

---

🧪 8️⃣ Uso via REXX

ADDRESS MVS
"D A,L"

📌 Alternativa segura:

ADDRESS SDSF
ISFEXEC DA

💬 Bellacosa comenta:

“REXX + console é espada de dois gumes.”

---

📊 Resumo rápido (cola de operador)

Categoria	Comando
Jobs ativos	D A,L
WTOR	D R,L
Spool JES	$D JOBS
Cancelar job	$C job
STC	S / P / F
IPL	D IPLINFO
Rede	D NET, D TCPIP
DASD	D U,DASD

---

☕ Conclusão Bellacosa Mainframe

“Console command não é para testar —
é para saber exatamente o que está fazendo.”

Em ambiente moderno:

• 👑 Operador usa console

• 🧪 Automação usa SDSF

• 🔐 Auditoria dorme tranquila

• 
  

⚖️ Lei da Casualidade — ou: nada acontece “do nada” (ao estilo Bellacosa Mainframe) ⚖️

 

Bellacosa Mainframe e a lei da casualidade

⚖️ Lei da Casualidade — ou: nada acontece “do nada” (ao estilo Bellacosa Mainframe) ⚖️

Eu sempre gostei de observar padrões. Talvez seja deformação profissional de quem passou a vida debugando COBOL, analisando dumps, JES2 lotado e aquele abend que “simplesmente apareceu”. No fundo, a tal lei da casualidade funciona exatamente assim: nada acontece por acaso absoluto — há sempre uma cadeia de eventos, mesmo que a gente não enxergue todas as linhas do JCL da vida.

---

🧠 O que é a Lei da Casualidade?

De forma simples:
👉 Todo efeito tem uma causa, ainda que seja sutil, invisível ou esquecida.

Ela aparece em várias filosofias:

• No budismo, como causa e efeito (karma)

• No taoismo, como fluxo natural das coisas

• Na filosofia ocidental, desde Aristóteles

• E no dia a dia… quando a gente diz:

  “isso não aconteceu por acaso”

Casualidade não é sorte.
Casualidade é consequência acumulada.

---

🏗️ Origem do conceito

O termo vem do latim causalis — aquilo que gera algo.
No Japão, isso conversa fortemente com ideias como:

• Inga ōhō (因果応報): causa e retribuição

• Shikata ga nai: aconteceu porque tinha que acontecer

• Mottainai: desperdiçar causa desequilíbrio

Nada surge do vácuo. Nem um bug crítico em produção 😄

---

💾 Bellacosa Mainframe Mode ON

Pensa assim:

• A vida é o sistema

• Suas ações são o código

• O resultado é o output

Se o batch deu erro, alguém:

• Alterou um copybook

• Esqueceu um IF

• Mudou um dataset

• Ignorou um warning

A casualidade é só o log dizendo:

“isso aqui já vinha sendo construído faz tempo”

---

🧩 Como entender na prática

✔️ Observe padrões recorrentes
✔️ Veja onde você insiste nos mesmos comportamentos
✔️ Analise os “pequenos eventos”
✔️ Aceite que nem tudo é imediato

Na vida, muito resultado é batch noturno — você só vê no dia seguinte.

---

🛠️ Como praticar (dicas reais)

• Pare de culpar o acaso

• Revise suas decisões passadas

• Aja melhor hoje (o efeito vem depois)

• Não ignore sinais pequenos

• Tenha paciência com o processamento

💡 Dica de ouro:

Se algo se repete, não é azar. É lógica.

---

🥚 Easter eggs & curiosidades

• No Japão, encontros “por acaso” são chamados de en (縁) — laços invisíveis

• Muitos animes usam isso como motor da história (Steins;Gate, Your Name)

• O “destino” japonês raramente é mágico — ele é construído

• Até o caos segue regras… só que muito complexas

---

😏 Fofoquices filosóficas

Sabe aquela pessoa que “sempre se dá mal”?
Ou aquela que “sempre cai em boas oportunidades”?

Spoiler:
👉 não é sorte
👉 é histórico de decisões + ambiente + atitude

O universo não pune nem recompensa — ele responde.

---

🌏 Importância cultural

A lei da casualidade ensina:

• Responsabilidade

• Consciência

• Humildade

• Paciência

• Observação

No Japão, isso molda:

• Relações pessoais

• Trabalho

• Ética

• Persistência

• Resiliência silenciosa

---

🧾 Fechando o job (sem abend)

“Nada acontece por acaso.
A gente só esquece de olhar o log.”

Entender a lei da casualidade é aceitar que cada pequena ação escreve uma linha do nosso próprio programa de vida. E quando o resultado vem… não adianta culpar o sistema.

Porque, no fundo,
o código foi nosso.

Como treinar IA para Mainframe

 

Passo a passo para evoluir legado em IA

Definição de Padrões Técnicos, Controle de Qualidade e Melhoria de Processos

Definir métricas de sucesso de qualidade específicas para COBOL em projetos de anotação de código e rotulagem de conjuntos de dados.

Desenvolver Procedimentos Operacionais Padrão (POPs), rubricas de garantia da qualidade (QA) e materiais de referência específicos para cada projeto, a fim de garantir que os resultados estejam alinhados com os padrões técnicos do cliente.

Revisar os resultados do projeto (scripts COBOL, anotações de código, exemplos de modernização de sistemas legados) em relação aos padrões definidos, sinalizando e corrigindo defeitos antes da entrega ao cliente.

Realizar verificações de QA estruturadas nos entregáveis; rastrear, sinalizar e resolver defeitos de forma eficiente para cumprir os prazos de entrega.

Devolver o trabalho aos contratados com notas de correção precisas e contexto sobre a sintaxe COBOL, lógica e padrões de sistemas legados.

Fornecer consultoria sobre ferramentas, frameworks, emuladores e melhorias de fluxo de trabalho para manter os padrões de qualidade em ambientes de mainframe e processamento em lote.

Lidar com alterações de especificações e cenários extremos (por exemplo, diferentes dialetos COBOL, codificação EBCDIC vs. ASCII, dependências de JCL) e elaborar os critérios de aceitação ou soluções alternativas correspondentes.

Organize bibliotecas de exemplos de código COBOL de "padrão ouro", exemplos de modernização e anotações de conjuntos de dados para calibração e consistência entre projetos.

Avaliação de Talentos e Melhoria de Resultados

Participe de avaliações técnicas de talentos terceirizados, incluindo a revisão de avaliações de código COBOL e avaliações baseadas em tarefas.

Revise exemplos de resultados de terceirizados e forneça feedback escrito claro e acionável para melhorar a correção, legibilidade e eficiência do código.

Desenvolva recursos de treinamento e calibração direcionados, como:

Diretrizes de qualidade de código COBOL (por exemplo, consistência de divisão de dados, estruturação de parágrafos)

Melhores práticas para código procedural limpo e de fácil manutenção

Documentação de referência para padrões de interação com sistemas legados

Padrões de rotulagem de conjuntos de dados para treinamento de modelos relacionados a COBOL

Suporte à Entrega de Projetos

Aconselhe sobre o escopo e os requisitos técnicos durante a configuração do projeto, incluindo versionamento de COBOL, integração de JCL e formatos de dados de mainframe.

Forneça orientação especializada para casos extremos e alterações de especificações, como o tratamento de copybooks, registros de comprimento variável ou integração com DB2 e VSAM.

Contribuir para as revisões pós-projeto a fim de capturar lições aprendidas e refinar continuamente os padrões.

Identificar e resumir insights do sistema do cliente, como problemas recorrentes de sintaxe, erros de lógica ou inconsistências na formatação de dados.

Criar painéis ou rastreadores de defeitos com problemas categorizados para revelar temas recorrentes e impulsionar melhorias de processo.

Conduzir análises pós-projeto para analisar tendências de defeitos e propor etapas de garantia de qualidade atualizadas, melhorias na documentação ou treinamentos de reciclagem.

Que beijinho mais gostoso o Luigi e os Esquilos natalinos.

 Feliz Natal do pequeno Luigi para a famiglia Bellacosa. O pequenino Luigi aprontando arte, brincando com os Esquilinhos dançantes. Na época para ele era uma loucura ouvir esses esquilinhos, ele adorava brincar, agarrar, abraçar, apertar as musiquinhas sempre fazendo bagunca com eles.

 

Bellacosa Mainframe e um Checklist de Auditoria Z/OS

📋 Checklist Executável de Auditoria z/OS (SMP/E + RACF)

Objetivo: permitir que o sysprog execute, colecione evidências e registre conformidade antes (e durante) uma auditoria.

---

🧭 Como usar este checklist

• Execute cada item na ordem

• Cole comandos/outputs como evidência

• Marque OK / N/A / FAIL

• Anexe decisões e aprovações quando houver

---

🔐 1) Controle de Acesso (RACF)

1.1 CSI protegido

• Evidência (exemplo):

RLIST DATASET HLQ.SMP.CSI ALL

• Esperado: UACC=NONE, ALTER restrito

1.2 Bibliotecas SMP/E protegidas

• Evidência:

RLIST DATASET HLQ.SMP.* ALL

1.3 IDs privilegiados revisados

• Evidência:

LISTUSER * SPECIAL

---

📦 2) Integridade do SMP/E (CSI)

2.1 CSI acessível e íntegro

• Evidência: job SMP/E simples (ex.: LIST)

2.2 Backup periódico do CSI

• Evidência: política / job de backup

---

🔁 3) Processo RECEIVE / APPLY / ACCEPT

3.1 RECEIVE documentado

• Evidência: output RECEIVE

3.2 APPLY CHECK executado

• Evidência:

SET BDY(TARGET).

APPLY CHECK.

3.3 APPLY aprovado e executado

• Evidência: output APPLY

3.4 ACCEPT autorizado

• Evidência: output ACCEPT + aprovação

---

🚨 4) Gestão de ++HOLD e ++ERROR

4.1 HOLDS analisados

• Evidência: cover letter / decisão

4.2 ERRORS tratados

• Evidência: APAR / mitigação

---

🧩 5) USERMOD

5.1 USERMOD identificado e justificado

• Evidência: histórico SMP/E

5.2 Plano de remoção definido

• 
  

---

🧪 6) Evidências Técnicas

6.1 Outputs arquivados

• 
  

6.2 JCL versionado

• 
  

---

🔄 7) Rollback / RESTORE

7.1 Processo RESTORE definido

• Evidência:

SET BDY(TARGET).

RESTORE.

---

🛡️ 8) Segurança e Atualizações

8.1 PTFs de segurança atualizados

• 
  

8.2 Backlog controlado

• 
  

---

🧾 9) Assinaturas e Responsáveis

• Sysprog: __________________ Data: //____

• Segurança: ________________ Data: //____

• Auditoria: ________________ Data: //____

---

🏁 Resultado Final

• 
  

Observações:

---

Checklist executável, evidenciável e auditável — estilo Bellacosa Mainframe.

Checklist executável criado com sucesso ✅

Ele já está pronto para:

• 🧪 execução técnica real (com comandos e evidências)

• 🛡️ auditoria interna e externa

• 📄 impressão / PDF

• 🎓 treinamento de sysprogs

Checklist Executável De Auditoria Z/os (smp/e + Racf)

📜 COBOL é Autoexplicativo? Problemas na documentação do legado.

  

📜 COBOL é Autoexplicativo?

Documentação, Mitos, Boas Práticas e Sobrevivência no Mainframe Real

“Se o código fosse realmente autoexplicativo, não existiria analista sênior, dump, nem planilha escondida na gaveta.”
— Provérbio não-oficial do Sysprog

---

1️⃣ O mito do COBOL auto-documentado

Desde sua origem, o COBOL foi vendido como uma linguagem:

• legível,

• próxima do inglês,

• acessível a gestores e usuários de negócio.

Na teoria:

IF CUSTOMER-STATUS = 'A'
   PERFORM PROCESS-ACTIVE-CUSTOMER
END-IF

Na prática, sabemos que:

• legível ≠ compreensível

• código não explica regra de negócio

• o “porquê” quase nunca está no fonte

📌 Primeiro choque de realidade
COBOL ajuda a ler a intenção técnica, mas não documenta contexto histórico, exceções fiscais, gambiarra regulatória ou acordo verbal de 1998.

👉 E isso não é culpa da linguagem. É da ausência de documentação.

---

2️⃣ Self-documenting code: sonho bonito, realidade dura

Existe um conceito romântico no mundo de software:

“Código limpo se documenta sozinho”

No mainframe isso vira rapidamente:

“Código limpo ajuda, mas não se explica sozinho”

⚠️ Gotcha clássico

IF WS-FLAG = 'Y'
   MOVE ZERO TO WS-TAX
END-IF

Perguntas que o código não responde:

• Por que zera imposto?

• Qual legislação?

• Em que data isso foi criado?

• Quem autorizou?

• Isso ainda é válido?

📌 Regra de ouro Bellacosa

Código mostra o que o sistema faz.
Documentação explica por que ele faz isso.

---

3️⃣ Onde a documentação realmente mora no COBOL

📂 3.1 No código (sim, mas com juízo)

❌ Comentário inútil

* Move value to variable
MOVE A TO B.

✅ Comentário que salva vidas

* REGRA FISCAL BR-ICMS-2017
* Conforme decreto 12.887, clientes com FLAG = 'Y'
* estao isentos de imposto nesta operacao
IF WS-FLAG = 'Y'
   MOVE ZERO TO WS-TAX
END-IF

📌 Comentário bom envelhece melhor que código bonito.

---

📘 3.2 Cabeçalho de programa (o RG do sistema)

Todo programa COBOL deveria começar com algo assim:

*****************************************************************
* PROGRAMA....: FINC1023
* DESCRICAO...: Calculo de impostos para faturamento
* MODULO......: Financeiro
* AUTOR.......: J. SILVA
* DATA........: 12/03/2017
* ALTERACOES..:
*  - 05/06/2019 - Ajuste ICMS MG (CHG#45871)
*  - 10/08/2022 - Isencao clientes FLAG=Y (LEGAL-889)
*****************************************************************

🧠 Easter Egg #1
Programas sem cabeçalho quase sempre:

• quebram em virada de ano

• explodem em auditoria

• ninguém quer assumir

---

4️⃣ Público-alvo da documentação: quem você está tentando salvar?

Nem toda documentação é para todo mundo.

🎯 Públicos clássicos no mainframe

Público	Precisa de
Desenvolvedor	Comentários técnicos, layout, lógica
Analista de negócio	Regras, exceções, impacto
Suporte/Produção	Fluxo, erros, RC, abends
Auditor	Rastreabilidade, histórico, motivo

📌 Erro comum
Achar que um comentário no código resolve tudo.

👉 Não resolve. Ele ajuda.

---

5️⃣ Padrões: o verdadeiro caminho do “autoexplicativo”

COBOL só fica “auto-documentável” quando existe:

• Naming convention clara

• Layout consistente

• Regras de codificação

• Comentários padronizados

❌ Legado sem padrão

01 A.
   05 B PIC 9(05).

✅ Código legível e sustentável

01 WS-INVOICE-TOTAL        PIC 9(07)V99.
01 WS-INVOICE-TAX          PIC 9(07)V99.

🧠 Easter Egg #2
Quem usa A, B, X1, X2 geralmente:

• herdou código sem documentação

• tem trauma de manutenção

• sabe interpretar dump no olho 😅

---

6️⃣ Documentando o “não documentado” (zona de guerra)

Agora vem a parte crítica.

⚠️ Realidade dura do mainframe

• Sistemas com 30, 40, 50 anos

• Regras que ninguém lembra

• Desenvolvedores se aposentando

• Conhecimento tribal indo embora

📌 O que fazer?

• Usar ferramentas modernas

• Mapear fluxos reais

• Analisar batch, CICS, DB2

• Documentar depois que entende

“Se está funcionando, existe uma regra.
Se ninguém sabe qual é, ela precisa ser documentada.”

---

7️⃣ COBOL, modernização e sobrevivência

Documentação não é nostalgia. É:

• pré-requisito de modernização

• base de DevOps

• segurança contra falha humana

• seguro contra auditoria

Sistemas mission critical não podem falhar.
E eles só sobrevivem porque:

• alguém documentou

• alguém deixou pistas

• alguém pensou no próximo

🧠 Easter Egg #3
O programa mais crítico da empresa:

• roda em batch às 02:13

• ninguém sabe explicar tudo

• mas todo mundo tem medo de mexer

---

8️⃣ Conclusão Bellacosa Mainframe

✔ COBOL não é mágico
✔ Código limpo ajuda, mas não basta
✔ Documentação é responsabilidade técnica
✔ Padrões salvam sistemas
✔ Comentários certos salvam carreiras

Documentar não é escrever mais.
É escrever o que o código nunca vai conseguir explicar.

☕💾