Voltar ao site
Português

Estudar código, documentação e material técnico

Documentação, uma framework que tem de dominar até segunda-feira, uma linguagem que quer aprender a sério em vez de copiar excertos: tudo funciona como qualquer outro tema. Esta página explica como meter material técnico, o que as explicações incluem, e o único sítio onde o áudio é a ferramenta errada.

💬
Pode seguir um tutorial até ao fim e continuar sem saber construir a coisa sem ele. Seguir não é saber.

Funciona da mesma maneira, com código nas explicações

Um tema técnico comporta-se como qualquer outro: torna-se um percurso de subtemas, o Modo Explicação percorre-os consigo, e as explicações incluem exemplos de código trabalhados a par dos diagramas e das caixas de aviso. Depois o Modo Questionário e o Modo Exame questionam-no. A diferença útil face a ler documentação é que a documentação nunca lhe pergunta nada de volta.

Meter material técnico

  • Documentação em PDF: quase todos os sites de documentação e referências de API podem ser impressos ou exportados para PDF, e isso carrega normalmente.
  • Um livro técnico ou o PDF de um curso: carregue-o por capítulos em vez de inteiro, para que cada tema mantenha um tamanho gerível.
  • Ou simplesmente descreva-o: «o ciclo de vida dos hooks do React», «como funciona a atenção nos transformers», «o fluxo OAuth device». Para uma tecnologia estabelecida costuma ser mais rápido do que procurar um documento, e é a via que os seus créditos gratuitos cobrem.
  • Não um repositório: não pode apontá-lo a um repo do GitHub nem a um URL, e não lê uma base de código. Carregue a documentação ou descreva o conceito.

O áudio é a ferramenta errada para código

A Leitura em voz alta diz o texto tal como está escrito, por isso um bloco de código é lido símbolo a símbolo e torna-se ruído inutilizável. É uma limitação real e vale a pena sabê-la antes de a experimentar numa secção técnica. A conversa falada lida com isso de outra forma e melhor: tem instrução de nunca ler em voz alta código, URL ou tabelas, e de dizer antes que está no ecrã, descrevendo o que faz.

Use o áudio para os conceitos e o ecrã para o código. Um episódio de podcast sobre «o que é uma condição de corrida e porque ajudam os bloqueios» funciona bem; um que leia a assinatura de uma função, não.

Explicar uma ideia técnica em voz alta

É aqui que o material técnico tira mais partido da conversa falada, porque grande parte do trabalho de quem programa é explicar uma decisão a outra pessoa. Raciocine em voz alta sobre porque usaria uma fila aqui, defenda uma escolha de esquema, ou tente explicar o que acha que um pedaço de código faz — e deixe-se pressionar onde estava a improvisar. É também o ensaio mais próximo de uma entrevista técnica, que tem a sua própria página.

Perguntas frequentes

Lida com código?
Sim. As explicações incluem exemplos de código trabalhados a par de diagramas e caixas, e os questionários e exames são gerados do mesmo material.
Posso carregar documentação de uma API ou um livro técnico?
Sim, em PDF. Quase toda a documentação pode ser impressa para PDF, e um livro longo carrega-se melhor capítulo a capítulo para que cada tema se mantenha gerível.
Posso apontá-lo a um repositório do GitHub ou a um URL de documentação?
Não. Não vai buscar URL e não lê uma base de código. Carregue a documentação em PDF, ou descreva a tecnologia e deixe-o construir o percurso a partir daí.
Consegue ler código em voz alta?
A Leitura em voz alta diz o texto exatamente como está escrito, por isso um bloco de código torna-se ruído símbolo a símbolo — não a use para código. A conversa falada é diferente: não lê código e descreve o que está no ecrã.
Posso usá-lo para aprender IA e aprendizagem automática?
Sim, e é uma das coisas sobre as quais mais temas se criam aqui. Descreva a área que quiser — arquitecturas de modelos, avaliação, prompting, o que for — ou carregue o artigo ou a documentação com que está a trabalhar.