Traduzi para coreano a documentação mais recente (8.1) dos guias do Rails.
(rails.insomenia.com)Eu era originalmente um veterano de Rails, mas fiquei indo e voltando entre stacks de frontend,
recentemente voltei para Rails e está muito bom.
O Rails 8 melhorou demais, e estou maratonando os vídeos recentes do DHH.
(Parece que o DHH está super ativo ultimamente. Também está criando bastante polêmica haha)
Os guias oficiais do Rails são realmente muito bem feitos,
mas como não havia uma documentação traduzida para coreano da versão 8 lançada este ano,
resolvi traduzi-la com a ajuda de IA.
Usei a API do Claude Sonnet 3.5
e escrevi um script em Ruby para traduzir automaticamente todos os arquivos Markdown,
e o script de tradução em Ruby foi feito com algumas rodadas de troca de ideias usando o editor Windsurf.
É um script que divide um arquivo Markdown em chunks adequados (cerca de 50 linhas, com a condição de não cortar blocos de código),
traduz cada parte e depois junta tudo novamente em um arquivo Markdown em coreano.
O custo das chamadas de API ficou um pouco acima de 30 mil won, e usei 3,2 milhões de tokens.
gpt-4o é muito melhor do que a tradução automática de antigamente, mas ainda tem partes que soam artificiais.
O Claude realmente escreve bem. Nos blocos de código ele não traduz o código, apenas os comentários,
e embora talvez não supere um tradutor profissional, acho que o resultado ficou melhor do que se eu passasse alguns meses traduzindo sozinho.
Também considerei o DeepL, mas para texto comum ele é bom;
já para Markdown e blocos de código, parece que ele não lida tão bem.
Espero que isso seja útil para desenvolvedores Rails!
6 comentários
Obrigado pelo ótimo material. Embora aqui e ali haja textos que não deveriam ter sido traduzidos, mas foram, a qualidade geral é boa. Por acaso você também ajustou separadamente o prompt de tradução?
A página de i18n precisa de alguns ajustes mesmo, obrigado pelo aviso! Não há nenhum segredo especial no prompt; no máximo, fui acrescentando prompts extras para as partes em que o resultado saía errado :)
Tenho curiosidade sobre como foi a sua experiência com o Windsurf.
Tenho usado bastante ultimamente no desenvolvimento
Antes disso usei o Cursor, e antes dele o Copilot, e a velocidade de desenvolvimento realmente aumenta
Não é que ele gere um código 100% perfeito, mas ele escreve bem códigos de padrão que uso com frequência
E um código desses levaria horas para eu escrever manualmente, enquanto a IA faz em poucos segundos
A empresa em que entrei como estagiário de cooperação universidade-indústria na época da faculdade usava Rails, e eu fiquei bem perdido porque quase não havia material em coreano... O livro de Rails que comprei naquela época agora está esgotado.
De qualquer forma, obrigado. Faz tempo que não dou uma olhada, acho que vou ver de novo!
Embora Rails seja mais de nicho, ainda existe bastante material em inglês, mas em coreano realmente quase não há.
Como a IA traduz bem, se houver demanda, estou pensando em criar materiais traduzidos de documentos relacionados a Rails.