GitHub Issues é quase o melhor caderno possível

• GitHub Issues é uma ferramenta poderosa e gratuita para notas públicas/privadas e colaboração
• Oferece uma experiência excelente de anotações com suporte a Markdown, destaque de código, arrastar e soltar imagens e vídeos e recursos de interligação
• Conta com busca poderosa e permite automação, backup e integrações externas via API
• O único ponto fraco é a ausência de funcionalidade offline com sincronização, o que dificulta o uso sem conexão de rede
• Checklists, processamento em larga escala, uso com LLMs, além de backup e segurança dos dados, também são grandes vantagens

---

O valor do GitHub Issues para anotações

• GitHub Issues pode ser considerado quase o melhor caderno online disponível
• Permite criar e gerenciar notas públicas e privadas ilimitadas gratuitamente
• O suporte a Markdown é excelente, com realce de sintaxe para praticamente todas as linguagens de programação, além de permitir arrastar imagens diretamente para a nota

Links e recursos de interligação

• Ao adicionar a URL de outra issue em uma lista Markdown dentro de uma issue, o sistema busca o título automaticamente e cria links mútuos de forma automática
• As regras de visibilidade das issues são aplicadas, então issues privadas não ficam expostas externamente

Busca poderosa e automação com API

• Um dos grandes pontos fortes é a busca rápida e precisa em um repositório, em todos os repositórios do usuário ou em todo o GitHub
• É possível exportar facilmente os dados das notas pela API ou criar e editar novas notas
• Também dá para implementar ampla automação conectando eventos de issue ao GitHub Actions

Desvantagem: falta de sincronização offline

• A única desvantagem é que não há sincronização quando não existe conexão com a internet
• Por isso, no celular, costuma-se usar em conjunto aplicativos com suporte offline/sincronização, como o Apple Notes

Segurança, praticidade, checklists e escalabilidade para grande volume

• As preocupações com segurança tendem a ser baixas. Empresas investem na confiabilidade do GitHub, e a plataforma tem alta credibilidade
• Como toda plataforma de notas pode ter risco de vazamento por bugs, dados sensíveis não devem ser armazenados
• Como não exige cobrança nem self-hosting, o risco de perder as notas é menor
• É muito útil usar checklists em Markdown (- [ ] item) ou referências a issues (- [ ] #ref)
  • Quando a issue correspondente é fechada, a marcação é feita automaticamente
• Também é possível testar vários métodos de backup (ex.: github-to-sqlite)
• A escalabilidade também é excelente, com casos como o repositório do vscode, com 190 mil issues, e o repositório do flutter, com mais de 100 mil

LLMs e outros usos

• Também é fácil encadear os dados das issues para LLMs e outras IAs generativas
• Na prática, já houve experiência em resumir um tópico de issue com mais de 50 comentários e 1,5 ano de histórico, organizando tudo em um novo comentário

Agregação e uso de dados de atividade

• É possível agregar a quantidade de issues e comentários criados no GitHub usando uma query GraphQL

{  
  viewer {  
    issueComments {  
      totalCount  
    }  
    issues {  
      totalCount  
    }  
  }  
}  

• O resultado real foi 9.413 issues, 39.087 comentários, totalizando 48.500 itens ao longo dos anos

Conclusão

• O GitHub Issues se destaca em gratuidade, colaboração, automação, busca, escalabilidade e versatilidade
• Se tivesse sincronização offline, seria na prática a melhor solução de caderno digital

[GN⁺]

Opiniões do Hacker News

• Compartilhamento de uma experiência de usar o GitHub Issues como ferramenta de gerenciamento de projeto ao preparar o próprio casamento. No começo, a esposa achou estranho, mas adicionar labels, pesquisar e colaborar ficou muito fácil, então foi possível concluir as tarefas do casamento no prazo. A parte mais difícil, pelo que lembra, foi criar um bookmark com link direto para o rastreador de issues. Recentemente, ao se mudar de casa, também usou o GitHub Issues para organizar caixas. Criava uma issue para cada caixa, escrevia na descrição o conteúdo dela e deixava o número da issue anotado na caixa; depois, conseguia encontrar facilmente em qual caixa estava cada coisa usando a busca do GitHub

  • Pergunta por curiosidade se outras soluções também foram testadas e por que ficaram aquém

  • Uma curiosidade simples: não seria possível apenas escrever o conteúdo diretamente do lado de fora da caixa?

  • Isso lembra uma história sobre um projeto de reforma de casa que viu no Hacker News. Parece ter sumido do GitHub agora, mas apresenta o link do projeto

  • No emprego anterior, tentaram usar o GitLab como ferramenta geral de gerenciamento de projetos, mas a adoção parou por falta de referências entre projetos. Para projetos open source, parecia adequado, mas na empresa atual o GitLab consegue substituir o YouTrack e já substituiu também o Upsource

  • Lembra da tirinha xkcd 1172. Há muitas histórias divertidas assim, e existem bastante pessoas no mundo com workflows absurdos. Esse tipo de coisa sempre é melhor de resolver com a ferramenta apropriada. Como referência, já organizou uma mudança internacional usando Org mode. Tem um perfil que não tolera de jeito nenhum entregar informações pessoais à Microsoft

• Fato interessante: se colar a query GraphQL abaixo no GitHub GraphQL Explorer, dá para ver na hora o total de issues e comentários que a pessoa já publicou no GitHub

  {
    viewer {
      issueComments {
        totalCount
      }
      issues {
        totalCount
      }
    }
  }
  

  A pessoa registrou 9.413 issues e 39.087 comentários, totalizando 48.500

• Esperava que o primeiro comentário fosse sobre privacidade, mas surpreendentemente não foi. A pessoa não deixa tantas notas assim, mas considera que esse tipo de dado é ainda mais pessoal do que e-mail. Não quer que esse tipo de informação pessoal seja usado para treinar LLMs. Fica a dúvida se a Microsoft oferece algum tipo de garantia de privacidade para repositórios privados

  • Como há uma enorme quantidade de segredos corporativos extremamente sensíveis no GitHub Issues, a suposição é que segurança e privacidade devam ser muito fortes. Muitas empresas confiam código-fonte e artefatos relacionados ao GitHub e pagam muito dinheiro por isso, então construir confiança é parte central do modelo de negócios da empresa. A opinião é que ela não arriscaria treinar modelos com segredos dos clientes

  • Sobre a pergunta “a Microsoft garante a privacidade de repositórios privados?”, apresenta um link para a discussão relacionada aqui

• Questiona-se a afirmação de que “a busca do GitHub é excelente”. Por exemplo, mesmo quando existe um comentário com a frase exata “current logs could do with a bit of redesign”, só é possível encontrá-lo se estiver entre aspas, e a busca falha por conta de erros de digitação como “redesing”

  • Resposta concordando. A impressão é que a busca do GitHub é apenas “busca”, não “uma ótima busca”

• Assim como acontece comigo, muita gente tenta encontrar o melhor app de notas e acaba sempre voltando para empilhar arquivos Markdown em um repositório Git

  • Se a ideia é continuar usando essa abordagem, compartilha a experiência de que a combinação Obsidian + Git Plugin foi a melhor. No desktop funciona de forma fantástica, mas no iOS exige um pouco de configuração

  • Sugestão de experimentar um app de notas open source gratuito. Declarando-se cliente da empresa, apresenta o em como um app de notas bonito e minimalista para organizar o pensamento pessoal

  • Em comparação com apps que fazem sincronização bidirecional automática em todos os dispositivos, a abordagem de ter que fazer manualmente commit/push/pull a cada nota nova ou editada parece antiquada

  • Com essa pessoa é parecido, mas usa arquivos Org-mode em vez de Markdown e adiciona tags do org-roam aos poucos quando necessário

  • Compartilha a experiência dolorosa de ficar indo e voltando entre Apple Notes e uma pasta de Markdown. A pasta de Markdown oferece melhor compatibilidade futura, mas o Apple Notes se destaca em design, simplicidade e suporte a mídia. Quanto mais recursos um app de Markdown oferece, mais fechado ele tende a ficar, e até os apps de leitura precisam suportar todos esses recursos. No fim, decidiu continuar no Apple Notes, mas desta vez está fazendo de novo a migração manual para uma pasta Markdown via Obsidian. Usou a exportação, mas a formatação ficou péssima e agora precisa revisar todas as notas

• Com a opção “keep downloaded” do iCloud, agora é possível manter todas as pastas e arquivos salvos localmente. Com isso, qualquer app que salve arquivos no iCloud passa a oferecer tanto trabalho offline quanto sincronização automática online

  • Curiosidade sobre como o sistema lida com conflitos de sincronização e qual é o intervalo de sincronização

  • Pergunta se, ao mover pastas, o iCloud ainda usa o método de baixar tudo e depois fazer upload de novo

• Apresenta como alternativas usar o Codeberg para evitar vendor lock-in ou hospedar o próprio Forgejo

  • Opinião de que uma grande vantagem do GitHub Issues é justamente não precisar hospedar por conta própria e o custo ser “0”. A pessoa não quer correr o risco de perder notas por erro de configuração ou problema de cobrança

• Visão de que o GitHub Issues é o melhor bug tracker/sistema de tickets. Elogios à interface por ser intuitiva, simples e rápida. Há, porém, uma leve preocupação de que um redesign da Microsoft possa estragar isso

  • Embora já tenha usado vários rastreadores de issues no trabalho, esta pessoa sentiu que o GitHub carece de alguns recursos importantes. Especificamente: não dá para escrever um resumo da issue separado dos comentários, faltam controles avançados de acesso (por exemplo, mostrar apenas certas issues para algumas pessoas) e não existe a função de adicionar notas pessoais privadas como rascunho temporário em vez de comentário público

  • Expressão metafórica de que o propósito do Azure DevOps parece ser agir como um “poço gravitacional” que impede a filosofia de marketing da Microsoft de ser absorvida pelo GitHub

  • Aponta-se que a abertura já piorou, com barreira de login e uma limitação rápida do número de issues pesquisáveis

• É uma pena não haver suporte a federação. A centralização de grandes repositórios de código é vista como uma estrutura que toda a comunidade de desenvolvedores deveria evitar. O recurso de merge requests federados do GitLab (issue relacionada) está sem novidades há 9 anos. Só esse recurso já permitiria colaborar como no git sem que todos precisassem usar um sistema centralizado. Como referência, cita-se o episódio recente em que a Microsoft bloqueou a conta de e-mail do procurador-chefe do Tribunal Penal Internacional por ordem do governo dos EUA. A ironia é que isso aconteceu pouco depois de a empresa divulgar que enfrentaria a União Europeia. Como Trump não suporta a UE, existe o risco real de que um dia ele ordene à Microsoft bloquear o acesso europeu ao GitHub, e ela possa fazê-lo. O alerta é para pensar bem no impacto que isso teria sobre negócios e open source

  • Opinião de que, não só a tecnologia chinesa, mas também a confiabilidade da tecnologia americana se tornou instável, então órgãos públicos e governos precisam reconsiderar seriamente sua dependência de tecnologia de um único país

  • Vontade de testar alternativas como Radicle. A sensação é de que, se esperar a situação piorar para começar, depois vai se arrepender

• Parece quase igual ao Obsidian, mas com um pouco mais de etapas

  • Brincadeira de que uma dessas etapas talvez seja “pagar US$ 50 por ano para acessar em todos os dispositivos” ou “US$ 100 por ano para acessar pela web”

  • Na verdade, o próprio Obsidian também parece apenas texto com algumas etapas extras. Mas, no fundo, arquivos de texto são extremamente poderosos, e existem várias formas de sincronizá-los entre dispositivos

  • Ao contrário do Obsidian, o GitHub Issues é somente online. Se não for possível fazer backup, isso certamente é um problema

  • Curiosidade sobre a possibilidade de hospedar o Obsidian por conta própria. Para uso profissional, há preocupação com segurança, então sugere-se deixá-lo apenas localmente e fazer backup só dos arquivos Markdown via OneDrive