-1
gabrielbaiano
3 min de leitura ·

Pitch: 🤖 Chega de Traduzir Changelogs! Automatize Seus Posts no TabNews com o `tabnews-release-publisher`!

Quem nunca se viu na situação de ter que traduzir e adaptar manualmente as notas de lançamento de um projeto open source para plataformas como o TabNews, buscando engajamento da comunidade brasileira? É um trabalho que, além de repetitivo, consome um tempo precioso que poderia ser investido no código!

Pensando nisso, temos o prazer de anunciar o tabnews-release-publisher, uma ferramenta oficial que chegou para simplificar (e automatizar!) essa tarefa. Ele está oficialmente pronto para te ajudar a compartilhar o progresso, lançar atualizações e coletar feedback para seus repositórios GitHub, tudo isso de forma automática e otimizada para o TabNews!

🌟 Por Que Você Vai Amar o tabnews-release-publisher?

  • 📈 Visibilidade Instantânea: Seus updates chegam direto à comunidade altamente engajada de desenvolvedores brasileiros do TabNews, garantindo tração imediata para suas novidades.
  • ⚡ Zero Complicações: Escreva suas notas de lançamento em inglês no GitHub, e deixe nosso bot cuidar da tradução, adaptação cultural e do tom para o português brasileiro (PT-BR) automaticamente.
  • 🎭 Tom Sob Medida: Escolha o tom ideal para cada tipo de lançamento! Use propaganda para convidar testadores beta, divulgacao para grandes lançamentos, ou update para logs mais técnicos e diretos.
  • 🤖 Motor AI Universal: Alimentado pela sua escolha de APIs como Google Gemini, OpenAI ou Claude/Anthropic, garantindo flexibilidade e resultados de alta qualidade.

🚀 Primeiros Passos (É Mais Fácil do Que Parece!)

Configurar o tabnews-release-publisher é super rápido, leva menos de 2 minutos! Você só precisa de três coisas para começar a automatizar seus posts:

  1. O Workflow Step: Adicione estas poucas linhas ao seu arquivo .github/workflows/release.yml:

    - name: Publish to TabNews
  uses: GabrielBaiano/tabnews-release-publisher@v1
  with:
    tabnews_email: ${{ secrets.TABNEWS_EMAIL }}
    tabnews_password: ${{ secrets.TABNEWS_PASSWORD }}
    ai_provider: 'gemini' # Ou use openai / anthropic
    gemini_api_key: ${{ secrets.GEMINI_API_KEY }} # Ou use openai_api_key / anthropic_api_key

  2. GitHub Secrets: Adicione as seguintes credenciais nas Settings > Secrets and variables > Actions do seu repositório:

    • TABNEWS_EMAIL (seu e-mail de login no TabNews)
    • TABNEWS_PASSWORD (sua senha do TabNews)
    • GEMINI_API_KEY (ou OPENAI_API_KEY / ANTHROPIC_API_KEY, dependendo da sua escolha de IA)

  3. Fique de Olho no README: Certifique-se de checar o README do projeto para configurações avançadas, como modelos de IA personalizados ou a personalização de tons!

🔮 O Que Vem Por Aí? (Upcoming Features)

Estamos sempre pensando em como melhorar e expandir as funcionalidades do bot. Aqui está um vislumbre do que planejamos para as próximas versões:

  • 🙋 Ajuda/Triagem Automática: Postar automaticamente issues complexas ou bugs no TabNews para obter soluções e feedback valioso da comunidade.
  • 🏆 Destaque de Contribuidores: Rastrear e destacar automaticamente os principais contribuidores entre as releases, incentivando e recompensando sua comunidade.
  • 📊 Monitoramento de Saúde do Código: Compartilhar automaticamente o progresso do código, métricas e atualizações sobre a saúde do projeto diretamente em fóruns de desenvolvedores.

🤝 Venha Construir Conosco!

Este é um projeto open source e adoraríamos ouvir você! Sua opinião e contribuição são fundamentais para o crescimento e aprimoramento do tabnews-release-publisher.

Se você tem sugestões, encontrou um bug ou quer adicionar suporte para um novo provedor de IA, sinta-se à vontade para abrir uma Issue, iniciar uma Discussion ou enviar um Pull Request diretamente em nosso repositório. Vamos construir juntos!

👉 GabrielBaiano/tabnews-release-publisher

Qual funcionalidade você gostaria de ver primeiro? Deixe seu feedback nos comentários!

Este post foi gerado de forma automatizada por um robô contribuidor que traduz e compartilha lançamentos importantes no TabNews.

Carregando publicação patrocinada...
2

Fala glra! Tomei um hate no discord por causa desse repo.

Queria explicar um pouco o contexto por trás da criação do tabnews-release-publisher e por que esse tipo de ferramenta é tão comum lá fora.

Em comunidades e ecossistemas grandes como o Reddit, Dev.to, Hashnode, e até em canais corporativos de Discord e Slack, a automação de releases e changelogs através de pipelines de CI/CD (GitHub Actions, por exemplo) é um padrão de mercado. Existem ferramentas consagradas de crossposting e broadcasting (como integrações oficiais do GitHub, bots de RSS-to-Reddit, etc.) que existem justamente para resolver um problema: o a complexidade de atualizar manualmente a comunidade a cada entrega importante e centralizar o post em um lugar/perfil.

A ideia do projeto não é, de forma alguma, automatizar spam ou poluir o TabNews com micro-atualizações irrelevantes (como - fix: typo). O foco é ajudar criadores de projetos sérios e bibliotecas open-source a manterem sua base de usuários atualizada aqui dentro, sem precisar parar o fluxo de trabalho para formatar manualmente o Markdown em múltiplos lugares.

4

Vou dar minha opinião sobre o que pode ter sido motivo dos votos negativos e "hate no Discord".

Não é que você queira automatizar spam, nem que isso vá acontecer, mas sim que dificilmente as publicações geradas serão úteis.

Changelog já não costuma ser muito útil, principalmente dependendo do projeto. Às vezes é uma lista de mudanças (como mensagens de commit) e que "com sorte" alguma é relevante pra você. Quando é algo mais elaborado, tem mais chances de ser útil, como eu mostrei em Comemore o progresso com seus clientes e mostre o valor do que foi feito.

Falar o porquê daquilo ser útil para o usuário/cliente, dar dicas de como aquilo pode ser usado, é mais útil do que o changelog puro. Tem mais "marketing" envolvido, sim, mas não só com o objetivo de chamar atenção, e sim com o objetivo de ser mais útil.

Outro ponto é que, mesmo que a publicação seja útil para quem usa o projeto em questão, a intersecção com o público do TabNews pode ser bem pequena, então para muitos será irrelevante (não conhece o projeto e está vendo só uma lista de features e bug fixes).

Projeto criativo, mas minha opinião está acima! Se conseguisse evoluir para o que eu comentei ("changelog marketeiro"), acho que poderia ser muito útil para os clientes (e talvez tivesse mais espaço no TabNews como Pitch). Ainda precisaria de cuidado para não ser tão frequente (toda release disparar a comunicação).

2

Nossa man, agradeço mt o feedback. Eu tinha ficado meio pra baixo porquê nos lugares que eu mostrei eu acabei só tendo criticas e downvotes sem feedback.

Entendi muito seu lado, concordo total acho que a ideia teria que evoluir e que não tá interessante. Não planejava usar em todo post de mudança ou feature, mais releases para mostrar as mudanças da nova versão e etc.

Acho que talvez tenha mais futuro usar para centralizar post em uma conta ou com esse changelog marketeiro como vc falou, talvez usar para referenciar coisas do desenvolvimento que paira no repo. Não sei, tem que testar a ideia.

Mas obrigado pela opnião e ideias!

2

Experiência própria: muitas releases que faço agregam pouca coisa (uma correção pontual de bug, ou uma funcionalidade nova que um cliente específico pediu). Dependendo do projeto, pode ter um volume grande de releases, por isso comentei desse cuidado.

Até uma integração por e-mail, como newsletter, ou blog post, poderia ser interessante. Um caso similar do O GitHub Issues será meu canal de suporte, que usou emails -> GitHub Issues, mas aqui seria GitHub Releases -> Emails.

Toda essa evolução que pensei pode ser interessante como SaaS, mas dá trabalho pra polir e criar algo bom (se já vi conteúdo bom gerado automaticamente por IA a partir de um input mais simples como seria o changelog, foi bom a ponto de eu não perceber). Nesse caso eu sugiro nem me escutar, mas sim procurar demanda REAL, e eu até escrevi um comentário sobre isso hoje.

Reforço: se for evoluir o produto para virar um negócio, realmente não me escute! Procure clientes reais :)

Sei que votos negativos sem feedback podem te desanimar, mas faz parte e acontecerá isso na sua vida de várias formas diferentes (TabNews, trabalho ou qualquer outro contexto). Fico feliz que contribuí com você.