// notas editoriais //
Como este blog é feito
Por que o blog existe, como ele evoluiu, e como cada artigo é produzido — incluindo o papel da IA.
Por que este blog existeWhy this blog exists
Antes de qualquer coisa, este blog é um caderno técnico. Um lugar para registrar o que aprendi, o que construí, para onde viajei e como resolvi (ou não) um problema — de um jeito que eu mesmo consiga consultar depois.
Ele também é um arquivo pessoal: documentação de projetos, de decisões de carreira e de viagens, e um espaço para organizar ideias que, de outra forma, ficariam soltas. Não é um produto e não tenta convencer ninguém de nada — é o registro de alguém que prefere escrever para entender.
Before anything else, this blog is a technical notebook. A place to record what I learned, what I built, where I traveled and how I solved (or didn't) a problem — in a way I can look up later myself.
It's also a personal archive: documentation of projects, career decisions and travels, and a space to organize ideas that would otherwise stay loose. It isn't a product and it isn't trying to convince anyone of anything — it's the record of someone who'd rather write in order to understand.
Como o blog evoluiuHow the blog evolved
- 2015 O blog é criadoThe blog is created O blog nasce por volta de 2015 — sem uma rotina de publicação, mais como um lugar reservado para escrever.The blog starts around 2015 — with no publishing routine, more as a reserved place to write.
- 2020 Publicação regular, no WordPressRegular publishing, on WordPress É só por volta de 2020, durante a pandemia de COVID-19, que a publicação vira hábito. Nessa época o blog roda em WordPress.It's only around 2020, during the COVID-19 pandemic, that publishing becomes a habit. Back then the blog runs on WordPress.
- 2026 Migração para Jekyll + GitHub PagesMigration to Jekyll + GitHub Pages Em 2026 o blog migra para Jekyll no GitHub Pages, com design próprio. A IA teve um papel importante nessa migração — o Claude ajudou na migração e na implementação.In 2026 the blog moves to Jekyll on GitHub Pages, with a hand-built design. AI played an important part in that migration — Claude helped with the migration and the implementation.
Como os posts são feitosHow posts are made
Quase todo post começa em material meu: uma experiência, notas soltas, uma conversa, um experimento, uma observação, um projeto, uma viagem ou um problema que apareceu no caminho. Esse material bruto raramente já é um texto — são pedaços.
A partir daí, a IA pode ajudar a transformar os pedaços em algo estruturado: organizar as ideias, propor uma estrutura, melhorar a legibilidade, expandir explicações, apontar lacunas, pesquisar referências externas, adicionar citações e até transformar uma conversa numa série de artigos. Nada disso torna uma afirmação verdadeira automaticamente — a responsabilidade pelo que fica publicado continua sendo minha.
Almost every post starts from my own material: an experience, loose notes, a conversation, an experiment, an observation, a project, a trip, or a problem that came up along the way. That raw material is rarely already a text — it's fragments.
From there, AI can help turn the fragments into something structured: organize the ideas, propose a structure, improve readability, expand explanations, point out gaps, research external references, add citations, and even turn a conversation into a series of articles. None of that makes a statement automatically true — what gets published is still my responsibility.
Da matéria-prima ao artigoFrom raw material to article
- ExperiênciaExperience
- Notas & conversaNotes & conversation
- PesquisaResearch
- EstruturaStructure
- ArtigoArticle
Tipos de artigoArticle types
TécnicoTechnical
Problema, investigação, arquitetura, implementação e o que deu errado. Quase sempre com um repositório no GitHub como companhia.A problem, the investigation, architecture, implementation and what went wrong. Almost always with a GitHub repository as its companion.
ViagemTravel
Roteiro, custos reais e o que a viagem foi de verdade — reconstruída a partir de registros pessoais, não só da memória.The itinerary, real costs and what the trip actually was — reconstructed from personal records, not just memory.
TeóricoTheoretical
Um conceito destrinchado. Quase sempre com origem prática: uma dor, uma conversa ou uma decisão real que virou pergunta.A concept unpacked. Almost always with a practical origin: a pain point, a conversation or a real decision that turned into a question.
Pessoal / carreiraPersonal / career
Relatos de carreira, mudança de país e escolhas — contados com números e datas sempre que possível.Career stories, moving countries and choices — told with numbers and dates wherever possible.
Como ler o que está aquiHow to read what's here
Um mesmo artigo costuma misturar quatro tipos de conteúdo. Vale saber qual é qual:A single article usually mixes four kinds of content. It helps to know which is which:
- Experiência pessoalPersonal experience O que eu de fato vivi, construí ou observei. É a matéria-prima de quase tudo aqui.What I actually lived, built or observed. It's the raw material for almost everything here.
- InterpretaçãoInterpretation A minha leitura daquilo — opinião, conclusão, recomendação. Pode estar errada e pode mudar.My reading of it — opinion, conclusion, recommendation. It can be wrong and it can change.
- Informação externaExternal information Fatos, números, especificações e regras que vêm de fontes de fora, checadas e referenciadas.Facts, figures, specs and rules that come from outside sources, checked and referenced.
- Síntese com IAAI-assisted synthesis Texto organizado, estruturado ou expandido com ajuda de IA a partir do meu material. Não torna nada verdadeiro por si só.Text organized, structured or expanded with AI help from my material. That alone doesn't make anything true.
Documentação de viagensTravel documentation
Posts de viagem são montados em três tempos — antes, durante e depois — e o mais importante é o "depois": a reconstrução honesta do que aconteceu, comparada com o que eu esperava.
Quando faz sentido, os relatos são cruzados com registros pessoais — histórico de localização do Google, extrato de cartão, reservas, fotos e anotações — para acertar horários e valores em vez de confiar na memória. Esses registros são pessoais: informação sensível é revisada antes de publicar, e detalhe nenhum entra no ar só para provar o método.
Travel posts are built in three stages — before, during and after — and the "after" matters most: the honest reconstruction of what happened, compared with what I expected.
Where it makes sense, the accounts are cross-referenced with personal records — Google location history, card statements, reservations, photos and notes — to get times and amounts right instead of trusting memory. Those records are personal: sensitive information is reviewed before publishing, and no detail goes live just to prove the method.
Como uma viagem vira postHow a trip becomes a post
AntesBefore
- Pesquisa e planejamentoResearch and planning
- Roteiro e reservasItinerary and reservations
- ExpectativasExpectations
DuranteDuring
- Lugares e observaçõesPlaces and observations
- Fotos e gastosPhotos and expenses
- O roteiro que aconteceu de verdadeThe itinerary that actually happened
DepoisAfter
- Reconstrução do que aconteceuReconstruction of what happened
- Lições e recomendaçõesLessons and recommendations
- Expectativa x realidadeExpectation vs. reality
Artigos técnicosTechnical articles
Artigos técnicos costumam vir acompanhados de um repositório no GitHub. O texto explica o problema, a investigação, a arquitetura, a implementação, os experimentos, as falhas, os resultados e o que ficou de lição. O repositório mostra a implementação de verdade — e como ela mudou ao longo do tempo.
A ligação é essa: artigo → código → commits → experimentos → entendimento atualizado. Quando um repositório já existe, ele é reaproveitado como companhia viva do texto, em vez de um trecho de código congelado.
Technical articles usually come with a GitHub repository. The text explains the problem, the investigation, the architecture, the implementation, the experiments, the failures, the results and the lessons. The repository shows the real implementation — and how it changed over time.
That's the link: article → code → commits → experiments → updated understanding. When a repository already exists, it's reused as a living companion to the text, rather than a frozen code snippet.
Artigo e código, lado a ladoArticle and code, side by side
- ArtigoArticle
- CódigoCode
- CommitsCommits
- ExperimentosExperiments
- Entendimento atualizadoUpdated understanding
Artigos teóricosTheoretical articles
Muito do conteúdo que parece teórico começou prático. O caminho costuma ser: experiência → conversa / reflexão → pesquisa → estrutura → artigo. Uma decisão real, uma dor concreta ou uma pergunta que surgiu num projeto viram o ponto de partida.
Uma única experiência pode virar um post, vários posts relacionados, uma série, ou uma investigação técnica e teórica mais funda. Por isso alguns textos abstratos têm uma origem bem concreta — e é bom lê-los sabendo disso.
A lot of what looks theoretical started out practical. The path is usually: experience → conversation / reflection → research → structure → article. A real decision, a concrete pain point or a question that came up in a project becomes the starting point.
A single experience can become one post, several related posts, a series, or a deeper technical and theoretical investigation. That's why some abstract pieces have a very concrete origin — and it's worth reading them with that in mind.
O papel da IAThe role of AI
A IA faz parte do fluxo de publicação deste blog, e não faz sentido esconder isso. Ela ajuda a estruturar, pesquisar, conectar e escrever — e teve papel importante na migração de 2026 para Jekyll + GitHub Pages, feita com o Claude.
O que a IA não é: a autora das experiências. Elas são minhas. A divisão que uso é simples:
AI is part of this blog's publishing workflow, and there's no point hiding it. It helps structure, research, connect and write — and it played an important part in the 2026 migration to Jekyll + GitHub Pages, done with Claude.
What AI is not: the author of the experiences. Those are mine. The split I use is simple:
Eu trago a experiência, o contexto, as perguntas e o julgamento. A IA ajuda a estruturar, pesquisar, conectar e expressar.I bring the experience, the context, the questions and the judgment. AI helps structure, research, connect and express them.
Fontes e referênciasSources and references
Quando um post depende de fatos externos, eles vêm de fontes verificáveis: documentação oficial, especificações técnicas, material acadêmico ou de pesquisa, sites de referência e fontes primárias — e fontes secundárias confiáveis quando cabível.
As referências existem para apoiar e dar contexto à experiência do autor, não para substituí-la. Se um número ou uma regra importa para o argumento, ele é checado e linkado.
When a post depends on external facts, they come from verifiable sources: official documentation, technical specifications, academic or research material, authoritative websites and primary sources — and reputable secondary sources where appropriate.
References are there to support and contextualize the author's experience, not to replace it. If a number or a rule matters to the argument, it's checked and linked.
Correções e evoluçãoCorrections and evolution
Os posts não são publicações imutáveis. Informação envelhece, implementações mudam, links somem e uma experiência nova pode derrubar uma conclusão antiga.
Quando faz sentido, um post é atualizado em vez de ficar congelado. A data de "atualizado em" no artigo indica quando isso aconteceu por último.
Posts aren't immutable publications. Information ages, implementations change, links disappear, and a new experience can overturn an old conclusion.
Where it makes sense, a post is updated rather than left frozen. The "updated on" date in the article shows when that last happened.
PrivacidadePrivacy
O blog envolve histórico de viagem, gastos, projetos e experiências pessoais. Informação sensível — de terceiros ou minha — é revisada antes de publicar, e dados privados não vão ao ar só para demonstrar o método.
Nomes de pessoas privadas são omitidos ou generalizados; identificadores como reservas e códigos de confirmação são removidos; coordenadas e metadados de fotos são limpos.
The blog involves travel history, expenses, projects and personal experiences. Sensitive information — other people's or mine — is reviewed before publishing, and private data doesn't go live just to demonstrate the method.
Private individuals are left unnamed or generalized; identifiers such as bookings and confirmation codes are removed; photo coordinates and metadata are stripped.