Cenário

As aulas são conduzidas em um laboratório com computadores desktop, com uma turma de aproximadamente 18 pessoas do curso de Ciência da Computação. Os alunos tinham conhecimentos desnivelados de programação: alguns já atuavam profissionalmente, enquanto outros estavam dando os primeiros passos na área.

Preparação

Uma aula antes da aplicação da Programação por Pares foi dedicada a uma atividade de nivelamento. É importante perceber que, para cada experiência, você pode encontrar um cenário diferente; aí entra a sensibilidade do professor para preparar bem os alunos para a atividade.
Nessa atividade niveladora em particular, revisitamos os conceitos de listas em Python, fizemos operações com listas, laços, condicionais, list comprehension e funções lambda. Dessa forma, no encontro seguinte haveria menos lacunas a preencher.
O material para esta aula está documentado neste link do GitHub:

Aplicação da técnica

A Programação por Pares consiste em dois programadores trabalhando juntos em uma única máquina, compartilhando o teclado e o mouse, e escrevendo código de forma colaborativa. Um programador atua como “motorista” (ou driver), escrevendo o código, enquanto o outro atua como “navegador” (ou observer), revisando o código em tempo real, dando sugestões e identificando potenciais erros. Os papéis são alternados regularmente.
Costumo dar um tempo de 7 a 10 minutos por rodada até que ocorra a troca de papéis. No dia a dia profissional, essa técnica em geral é aplicada por dois colegas que alternam entre si. Entretanto, na minha aula promovo um rodízio de duplas, para incentivar a integração entre todos os participantes. Assim, ao final de cada rodada, os navegadores mudam para a estação à direita, e os drivers para a estação à esquerda. Na nova estação, eles alternam os papéis: quem era driver passa a ser navegador e vice-versa.

Resultado

Nessa experiência em particular, foram realizadas oito rodadas com tempo variando de 7 a 10 minutos. Ao final, os participantes compartilharam suas impressões, destacando os pontos positivos e os desafios da atividade de programar em duplas.
As respostas foram diversas, entre aspectos positivos e pontos de estranhamento:

• Dificuldade em continuar a atividade ao mudar de estação e se deparar com código feito por outra pessoa;
• Duplas bem afinadas eram desfeitas, e uma nova relação precisava ser construída rapidamente;
• Com as novas interações, habilidades foram adquiridas, assim como novas formas de abordar problemas;
• A comunicação nem sempre era eficaz em algumas duplas;
• O receio inicial de “não saber programar direito” foi superado com o apoio do navegador.

Ao final, desafiei os alunos a aplicar a técnica em projetos pessoais, utilizando ferramentas de teletrabalho com chamada de vídeo e compartilhamento de telas. Julgo que isso os prepara para compor equipes de desenvolvimento de software com mais confiança para enfrentar os desafios do dia a dia.

O que é Clean Code?

Clean Code, ou código limpo, é um conceito popularizado por Robert C. Martin (Uncle Bob) em seu livro de mesmo nome, que enfatiza a escrita de código que seja fácil de entender, modificar e manter. Isso inclui:

• Nomes claros e significativos para variáveis, funções e classes.
• Estrutura lógica e simples.
• Comentários apenas quando necessários.
• Evitar duplicação e complexidade desnecessária.
• Organização consistente e legível.

Por que ensinar Clean Code desde o início?

1. Cria bons hábitos desde o começo
   Aprender a programar é como aprender um novo idioma. Se você começar falando errado, vai ser difícil corrigir depois. Ensinar Clean Code desde o primeiro contato ajuda o aluno a desenvolver bons hábitos que serão naturais e automáticos no futuro.
2. Facilita o entendimento e a colaboração
   Mesmo que o aluno esteja escrevendo código só para si, a clareza é essencial. Quando o código é limpo, fica mais fácil revisar, corrigir erros e expandir funcionalidades. Além disso, em projetos reais, a colaboração é inevitável, e um código limpo é a base para um trabalho em equipe eficiente.
3. Reduz a frustração e o retrabalho
   Código confuso gera bugs difíceis de encontrar e corrige. Ensinar Clean Code ajuda a evitar esses problemas, tornando o aprendizado mais fluido e menos frustrante.
4. Prepara para o mercado de trabalho
   Empresas valorizam profissionais que escrevem código limpo porque isso economiza tempo e dinheiro. Ao aprender Clean Code desde cedo, o aluno já se destaca e está mais preparado para desafios reais.

Minha filosofia de ensino: aprender fazendo, com qualidade

Eu acredito que o aprendizado de programação deve ser prático, mas nunca às custas da qualidade. Por isso, desde o primeiro exercício, incentivo os alunos a:

• Escolher nomes que façam sentido.
• Dividir o código em funções pequenas e com responsabilidades claras.
• Refatorar o código sempre que possível.
• Escrever código que eles mesmos gostariam de ler no futuro.

Além disso, uso exemplos reais e situações do dia a dia para mostrar que Clean Code não é meramente um amontoado de regras vazias, mas uma ferramenta poderosa para programar melhor e com mais prazer.

Vamos tomar como exemplo a função ‘faz_algo()’ a seguir:

def faz_algo(x, y):
    a = x * 2
    b = y + 10
    c = a + b
    print(c)
    d = []
    for i in range(x):
        if i % 2 == 0:
            d.append(i)
    return d

resultado = faz_algo(5, 3)
print(resultado)

Problemas desta função:

1. Nomes não descritivos (faz_algo, x, y, a, b, c, d)
2. Faz duas operações não relacionadas (cálculo e filtragem de números pares)
3. Tem um efeito colateral (print) além de retornar um valor
4. Não tem tipagem de parâmetros ou retorno

Versão Refatorada com Clean Code

from typing import List

def calculate_combined_value(multiplier: int, additive: int) -> int:
    """Calcula um valor combinado com base nos parâmetros de entrada.
    
    Argumentos:
        multiplier: O número a ser duplicado.
        additive: O número a ser aumentado em 10.
        
    Retorna:
        O resultado de (multiplier * 2) + (additive + 10)
    """
    doubled_value = multiplier * 2
    increased_value = additive + 10
    return doubled_value + increased_value

def get_even_numbers_up_to(limit: int) -> List[int]:
    """Gera uma lista de números pares até o limite especificado.
    
    Argumentos:
       limite: O limite superior (exclusivo) para os números pares.

   Retorna:
        Uma lista de números pares de 0 até (mas não incluindo) o limite.
    """
    return [num for num in range(limit) if num % 2 == 0]

# Exemplo de uso
if __name__ == "__main__":
    # Cálculo do valor combinado
    result = calculate_combined_value(multiplier=5, additive=3)
    print(f"Calculated value: {result}")
    
    # Obtenção de números pares
    even_numbers = get_even_numbers_up_to(limit=5)
    print(f"Even numbers up to 5: {even_numbers}")

Princípios do Clean Code aplicados:

1. Single Responsibility Principle: Cada função faz apenas uma coisa
   • calculate_combined_value: apenas cálculos matemáticos
   • get_even_numbers_up_to: apenas geração de números pares
2. Nomes significativos:
   • Os nomes das funções e parâmetros deixam claro seu propósito
3. Tipagem explícita:
   • Uso de type hints para documentar os tipos esperados
4. Docstrings completas:
   • Documentação clara do propósito, parâmetros e retorno
5. Simplicidade:
   • Cada função é simples e fácil de entender
   • Uso de list comprehension para clareza
6. Sem efeitos colaterais:
   • As funções apenas retornam valores (exceto pelo print no bloco principal)
7. Organização lógica:
   • Separação clara entre as operações matemáticas e a geração da lista

Esta versão é muito mais fácil de:

• Manter
• Testar (podem ser testadas isoladamente)
• Reutilizar (cada função tem um propósito específico)
• Compreender (os nomes e estrutura são auto-explicativos)

Boas práticas que ensino desde o início

• Nomes descritivos: Variáveis e funções devem ter nomes que expliquem seu propósito.
• Funções pequenas: Cada função deve fazer uma coisa só, e fazê-la bem.
• Evitar duplicação: Reutilizar código para evitar erros e facilitar manutenção.
• Comentários úteis: Usar comentários para explicar “porquê”, não “o quê”.
• Indentação e espaçamento: Código bem formatado é mais fácil de ler.
• Testes simples: Introduzir a ideia de testar o código para garantir que funciona.

Conclusão

Ensinar Clean Code desde os primeiros contatos com programação é um investimento que traz retorno imediato e a longo prazo. Ajuda o aluno a construir uma base sólida, evita maus hábitos e prepara para o mercado de trabalho. Mais do que ensinar a programar, ensino a programar bem — com clareza, organização e responsabilidade.

Se você está começando a aprender programação, ou é professor, experimente incorporar o Clean Code desde o início. Você vai se surpreender com a diferença que isso faz!

Se quiser, posso lhe ajudar a criar um roteiro para uma aula ou um workshop sobre Clean Code para iniciantes. Quer?

Por isso, jovenzinhos, resolvi pensar como foi essa etapa importante do meu curso de doutorado, fazendo uma analogia com a Jornada do Herói.

1 – Mundo Comum

Até julho de 2021, eu era um professor com experiência em ensino médio, EJA, cursos técnicos e ensino superior na área de computação e jogos digitais. Minha atuação em sala de aula foi construída ao longo de quase 20 anos sujando as mãos de giz, e foi bastante contaminada, positiva e negativamente, pelos professores os quais eu me espelhei.

Assim, minha concepção sobre o que é ser professor mudou muito com o passar do tempo. Já associei a prática a uma espécie de sacerdócio, uma missão, já supus que ser um depósito de conhecimento que se transfere para outro depósito mais vazio como acontece em algumas leis da Física. Abandonando de certa forma essas posições, passei a pensar que docente é aquele que fornece os links, a base para que o aluno consiga construir seu próprio aprendizado. Foi com essa concepção que iniciei o semestre letivo.

2 – Chamado para a aventura

Outro desafio para alguém que está há tanto tempo em sala de aula, é conseguir se colocar na posição de aluno. Há alguns anos, eu tento assumir essa postura, que passa por algumas atitudes que para mim fazem sentido como, me calar, ouvir mais e falar de forma pontual. Para que, a pessoa que está conduzindo a disciplina, possa realizar a transformação que ela planejou.

Quando vi a oferta da disciplina, senti-me impelido a me matricular. Sempre quis me aprofundar nas dinâmicas que podem fazer da sala de aula um ambiente mais interessante.

3 – Recusa do chamado

4 – A mentora

Logo no primeiro encontro, conheci a professora Ana Lúcia Coelho, que me causou uma ótima impressão, pois conduziu a aula incentivando muito a participação de todos. Desta forma, as aulas foram muito vivas, com ideias o tempo todo colidindo e sendo transformadas em vários momentos eureca.

Esses momentos aconteciam nas intervenções dos colegas e da professora. Sendo possível aprender tanto com aqueles mais experientes, quanto com outros que ainda não tiveram nenhuma ou pouquíssima experiência docente.

5 – A primeira travessia

Agora já estava dentro da Matrix, o ambiente das aulas meramente expositivas ficou para trás. Neste novo lugar, abundaram estratégias digitais como padlets, podcasts, mapas conceituais, vídeo aulas, enquetes, nuvem de ideias e é claro, uma estratégia que espero conseguir implementar, que são as memórias de aula. Se a sala de aula já era um grande desafio, agora em uma realidade de ensino a distância isso se potencializou. Felizmente, nas aulas da disciplina nós pudemos falar sobre estratégias para contornar esses problemas. Cada reunião de grupo fazia nascer ideias, umas boas outras nem tanto, mas que eram debatidas sempre com muito respeito e camaradagem.

6 – Testes Aliados Inimigos

O apoio dos colegas foi muito importante em todos os encontros. Devido a minha rotina já mencionada, precisava da compreensão dos colegas e da professora devido às ausências momentâneas. Felizmente, sempre conseguimos negociar bem os horários de apresentação de trabalhos.

7 – Aproximação da caverna Oculta

Para mim, o momento mais esperado da disciplina foram as apresentações das metodologias ativas de ensino. Esses encontros foram muito ricos, pois eu estava ávido por aprender como aplicar cada uma daquelas estratégias em minhas aulas futuras. A turma foi dividida em duplas as quais deveriam apresentar as seguintes estratégias, para as quais pretendo criar textos em breve:

Brainstorming

Juri Simulado

Painel de notícias

Casos para ensino

Produção de História em Quadrinhos

Workshop

Estudo de Caso

Aprendizagem baseada em problemas (PBL)

Jogos Criativos

Mapa Conceitual

Música

Filme

Podcast

Instrução entre pares

Stop Motion

Ironicamente, no sorteio, eu e minha dupla ficamos na incumbência de apresentar a última estratégia STOP MOTION. Irônico porque é um estilo de animação que gosto muito, mas fiz muito pouco antes. Além disso, ficar por último em uma turma de pessoas mega talentosas é muito perigoso. A cada apresentação o sarrafo era colocado em uma posição mais alta, então, era nossa missão terminar esta parte da disciplina de forma, no mínimo, honrosa.

Penso que se tivéssemos menos estratégias apresentadas por dia, nós poderíamos aproveitar mais cada uma delas. Como cada grupo ficou com apenas uma hora para cada explanação e demonstração, ficou uma sensação de que poderia ter mais tempo para essa dinâmica de seminários. Essa é uma sugestão minha para outra edição dessa disciplina.

8 – Provação suprema

Foram vários dias de interação constante com meu parêa, Thiago Nascimento. Fizemos buscas por bibliografia, escrevemos roteiro e preparamos o tão esperado vídeo. O resultado é esse aqui embaixo.

9 – Recompensa

Após terminado o grande desafio, consegui tirar diversos ensinamentos. O primeiro é que nunca um trabalho vai ficar 100% aos olhos daquele que faz, isso dá margem para aprimoramentos. Segundo, apesar de ser um trabalho árduo gravar uma animação em stop motion, faz com que os produtores fiquem imersos no conteúdo do vídeo e façam diversas reflexões para ajustar texto, roteiro e para apresentar o tema de modo que todos consigam entender. Além do que, é bom demais ver a recepção das pessoas a um conteúdo produzido por você.

10 – O caminho de volta

Vencido o desafio, este é o momento de voltar ao mundo comum, o Pablo professor não é mais aquele do início da jornada. Na bagagem já tem várias outras ferramentas e itens mágicos que podem ser usados.  

A luta agora é contra as estruturas e as velhas práticas que inibiam a construção de uma sala de aula mais vibrante. E todos esses aspectos estão personificados no velho professor. Não no antigo, aquele que tem vários ensinamentos que trazia a informação da melhor forma que ele sabia, mas o velho mesmo, aquele que não tem mais lugar, o que mede o aluno pelo gabarito da prova, ou pelo comportamento.

11 – Ressurreição

Apesar de toda a aparente violência que a cena sugere, é importante que ambos os professores, o velho e o novo Pablo sejam feridos mortalmente. Com uma diferença, que o novo ressuscite, que possa ressurgir mais forte. Foi bem esse o sentimento que me veio a mente ao refletir sobre esse momento de embate dos dois mundos.

12 – Retorno com o elixir

O Rapper Emicida tem uma frase que diz “Então cerra os punho sorria E jamais volte pra sua quebrada de mão e mente vazias”. Na bagagem dessa jornada, eu voltei com muita coisa boa, várias estratégias, modos de pensar, ferramentas e o melhor, vários companheiros e companheiras de jornada, os quais fizeram tudo parecer mais suave.

13 – O novo professor

Felizes serão os alunos que tiverem como professores os discentes que cursaram a disciplina de Práticas de Ensino em Administração no período 2021.2. Pois, as salas de aula serão mais vibrantes quando tiverem que ser, mais reflexivas quando isso for exigido, e mais agregadoras de modo geral.               

E como a jornada nunca termina, vamos atrás de mais desafios!