6 pontos por GN⁺ 2025-08-03 | Ainda não há comentários. | Compartilhar no WhatsApp
  • Viveram-se mais de um ano com o problema de condição de corrida na busca do Mintlify sem conseguir melhorá-lo
  • Embora eu seja fundador da Trieve, a provedora do mecanismo de busca da Mintlify, não conseguia corrigir o problema diretamente por estar em posição de fornecedor, sem acesso ao código
  • No fim, depois de ingressar na Mintlify, resolvi diretamente o problema de cancelamento de consultas e sincronização de resultados usando AbortController
  • Destaquei que, se fosse open source, seria possível corrigir isso imediatamente por meio de um PR, enfatizando a vantagem concreta do código aberto
  • Mais uma vez, percebi a satisfação e a importância de melhorar o produto ao consertar pessoalmente até mesmo um incômodo pequeno

Não pude submeter um PR, então entrei para corrigir

O bug de busca da Mintlify que incomodou por mais de um ano

  • Na função de busca do Mintlify, uma condição de corrida fazia com que as queries fossem processadas em duplicidade e expunha resultados errados enquanto o usuário digitava
  • Eu era fundador da Trieve, o fornecedor (terceirizado) do mecanismo de busca do Mintlify, mas não tinha acesso à base de código, então não podia corrigir diretamente
  • O problema foi levantado várias vezes no canal compartilhado do Slack, mas como ficou com baixa prioridade, ficou abandonado por muito tempo
  • Toda vez que a experiência de busca da Trieve parecia ruim na Mintlify, eu sentia um peso no meu orgulho pessoal e na imagem da marca

Solucionei diretamente ao entrar para o time

  • Ao me juntar ao Mintlify, passei a ter acesso direto à base de código
  • Melhorei a função de busca implementando AbortController, fazendo com que as consultas de busca anteriores fossem interrompidas imediatamente
  • Agora, a cada vez que o usuário digita, apenas os resultados de busca mais recentes são aplicados, então sempre é possível ver resultados precisos e atualizados
  • A satisfação de consertar diretamente um problema que incomodava há tanto tempo é enorme
  • Como George Hotz, que entrou no Twitter por pouco tempo para consertar o pop-up de login, atribuo valor à postura de agir de forma hacker/empreendedora ao resolver problemas diretamente quando eles aparecem
  • Esse tipo de experiência prática e concreta de resolução de problemas me leva para uma carreira melhor

O valor prático do código aberto

  • Tenho preferência pessoal pelo desenvolvimento e uso de software de código aberto
  • Se fosse open source, a estrutura permitiria que um desenvolvedor externo enviasse Pull Requests (PR) com correções de bugs ou melhorias de funcionalidade
  • Se a busca da Mintlify fosse open source, esse problema mantido por um ano poderia ter sido resolvido imediatamente com PR
  • No modelo de fonte fechada, há a limitação de que só se pode melhorar com acesso ao código
  • Mesmo reconhecendo o valor de "concessão imediata de permissões" no ambiente open source, também entendo as diferenças de modelo de negócio de cada empresa

A satisfação de melhorar diretamente

  • A razão pela qual a busca da Mintlify ficou mais suave e responsiva é justamente essa melhoria
  • Ao corrigir diretamente um pequeno bug que ficou incomodando por muito tempo, senti a satisfação de contribuir para a evolução do produto
  • Por meio dessa experiência, percebi que o processo de corrigir repetidamente até mesmo problemas pequenos e triviais torna o produto muito melhor
  • Pequenas mudanças feitas diretamente se acumulam e levam a uma melhoria acelerada da experiência do usuário
  • Espero continuar fazendo produtos melhores por meio do acúmulo dessas pequenas melhorias

Ainda não há comentários.

Ainda não há comentários.