Tenha em mente que o próprio código já é a descrição mais adequada que você pode ter.
Traduzindo este código, em JavaScript:
for (let i = 1; i <= 3; i++) {
let linha = '';
for (let j = 1; j <= 3; j++) {
linha += `[${i}, ${j}]`;
}
console.log(linha);
}
Para uma das infinitas traduções em português, poderíamos fazer algo como:
- Enquanto i for menor ou igual a 3 (somando 1 à i após cada iteração), faça:
- Declare linha como string vazia.
- Enquanto j for menos ou igual a 3 (somando 1 à j após cada iteração), faça:
- Atribuir à linha o resultado da concatenação das strings:
"["
, i (em string),", "
, j (em string) e"]"
.
- Atribuir à linha o resultado da concatenação das strings:
- Invoque a função console.log passando, como primeiro argumento, linha.
É uma das infinitas possibilidades de tradução.
Note que, embora o funcionamento tenha sido corretamente traduzido de JavaScript para uma estrutura em português, assumindo que só possuíssemos a versão em português do algoritmo, não conseguiríamos assumir, com certeza, a estrutura sintática do código original. Conseguiríamos apenas reproduzir o funcionamento.
Claro, levando a tradução ao pé da letra, poderíamos acabar utilizando um for
e chegar em algo bem similar. Mas como, estritamente falando, a língua portuguesa não consegue expressar corretamente todas as estruturas sintáticas do JavaScript, poderíamos acabar escrevendo algo como:
let i = 1;
while (i <= 3) {
let linha = '';
let j = 1;
while (j <= 3) {
linha += '[' + i + ', ' + j + ']';
j++;
}
console.log(linha);
i++;
}
Ou, se seguíssemos somente o funcionamento do algoritmo expresso, poderíamos acabar chegando em algo mais diferente ainda.
Acabei indo além do que precisava, mas acho importante destacar esses pontos. Em suma, se a estrutura sintática do código não é importante, traduzi-lo para uma "linguagem humana" (como o português) pode ser uma opção razoável a depender da situação. No entanto, se essa estrutura for importante, escrever o código na linguagem original é a única opção que vejo como razoável.
A título de curiosidade, o padrão ECMAScript (a especificação que rege o JavaScript) não descreve os algoritmos dos built-ins da linguagem em JavaScript! É utilizada uma versão "inglesada" dos passos do algoritmo para que cada implementação possa montar o código que lhe convém, buscando, por exemplo, otimizações — que vão, na maioria das vezes, além do escopo de um padrão como esse.
Veja por exemplo a especificação do método Array.prototype.forEach
na seção § 22.1.3.12.