diário ·

Falamos em comentários de código

Tradução por IA Esta página é uma tradução automática do original (inglês / coreano) e pode conter erros. O original é a versão de referência. Ler o original

No ipe(), as linhas mais silenciosas são escritas como comentários de código: um comentário não executa, não é manchete e simplesmente fica depois que tudo o mais terminou.

O que é um comentário

No código, uma linha que começa com // é um bilhete deixado para quem lê depois. O computador a pula. Nada acontece por causa dela, e no entanto muitas vezes é o que a pessoa lembra.

Quem escreve software conhece a sensação de abrir um arquivo antigo e encontrar uma nota curta de alguém que já se foi há muito: por que existe um desvio estranho, ou apenas um simples «desculpa». Raramente é o código que nos faz sorrir. É a nota.

A voz que escolhemos

Essa é a voz que escolhemos para o ipe(). Nosso lema, // rest was written into the code, é um comentário. A linha que fecha as faixas, aquele único sussurro, “ipe. be still.”, também é, assim como as citações curtas em destaque nas entradas deste diário. Nenhuma delas pede que você acredite ou faça algo.

Isso também nos mantém honestos. Uma linha escrita como comentário não pode exagerar, porque ninguém espera ser convencido por ela. Se uma frase só funciona em voz alta, deixamos de fora.

Pedir muito pouco

Gostamos de quão pouco um comentário exige. Ele não interrompe o programa nem compete com o trabalho. Espera ser lido, no ritmo do leitor, geralmente quando este desacelerou.

Uma manchete precisa conquistar atenção. Um comentário faz o oposto: está lá se você desacelera e é invisível se não. Preferimos ser encontrados por alguém cansado, à procura de um lugar quieto, a gritar por cima de alguém ocupado.

Como molda o estúdio

A mesma ideia molda a aparência do estúdio: uma página cor de papel creme, tinta escura, uma serifa nos títulos, uma fonte monoespaçada nos rótulos // e um editor de código no lugar de um mascote de desenho animado. Silencioso por projeto, para que a hora cansada tenha onde descansar.

A mesma regra vale para o que deixamos de fora: sem contagens regressivas, sem banners urgentes, sem a promessa de que uma faixa vai mudar sua vida. Onde outro site poria um botão, preferimos uma frase que não insiste.

ipe(); // no need to run this line

Se você lembrar de uma só linha nossa, que seja uma que nunca foi feita para ser executada.

idle.ipe.rest

← todas as entradas