- GitHub Issues es una herramienta potente, gratuita y pública/privada para notas y colaboración
- Ofrece una experiencia excelente para tomar notas gracias al soporte de Markdown, resaltado de código, arrastrar y soltar imágenes y videos, y funciones de interenlace
- Tiene una búsqueda potente y permite automatización, respaldos e integraciones externas mediante la API
- Su única desventaja importante es la falta de una función offline con sincronización, por lo que es difícil usarlo sin conexión de red
- Checklists, manejo a gran escala, uso con LLM, así como respaldo y seguridad de los datos, también son ventajas clave
El valor de usar GitHub Issues para tomar notas
- GitHub Issues puede considerarse casi el mejor cuaderno en línea
- Permite crear y administrar notas públicas y privadas ilimitadas de forma gratuita
- El soporte para formato Markdown es muy bueno: ofrece resaltado de sintaxis para casi todos los lenguajes de programación y también permite arrastrar imágenes directamente a una nota
Enlaces y funciones de interconexión
- Si agregas la URL de otro issue dentro de una lista Markdown en un issue, carga automáticamente el título y crea enlaces mutuos de forma automática
- Se aplican las reglas de visibilidad del issue, por lo que los issues privados no quedan expuestos hacia afuera
Búsqueda potente y automatización con API
- Uno de sus puntos fuertes es la búsqueda rápida y precisa dentro de un repositorio, en todos los repositorios del usuario o en todo GitHub
- Con la API se pueden exportar fácilmente los datos de las notas, así como crear o editar notas nuevas
- También se puede implementar una automatización amplia conectando eventos de issues con GitHub Actions
Desventaja: no hay sincronización offline
- Su única desventaja es que no sincroniza cuando no hay conexión a internet
- Por eso, en móvil suele usarse junto con apps con soporte offline y sincronización como Apple Notes
Seguridad, comodidad, checklists y escalabilidad
- Las preocupaciones de seguridad tienden a ser bajas. Las empresas invierten en la confiabilidad de GitHub y la plataforma tiene alta credibilidad
- Como cualquier plataforma de notas, existe riesgo de filtración por bugs, así que no conviene guardar datos sensibles
- Como no requiere pagos ni self-hosting, hay menos riesgo de perder las notas
- Es muy útil aprovechar las checklists de Markdown (
- [ ] item) o las referencias a issues (- [ ] #ref)
- Cuando ese issue se cierra, se marca automáticamente como completado
- También se pueden probar varios métodos de respaldo (por ejemplo, github-to-sqlite)
- Su escalabilidad también es excelente: existen casos de gestión de más de 190 mil issues en el repositorio de vscode y más de 100 mil en el repositorio de flutter
LLM y otros usos
- También es muy fluido canalizar los datos de issues hacia LLM u otras IA generativas
- De hecho, hay experiencia resumiendo un hilo de issue de 1.5 años con más de 50 comentarios y organizándolo como un nuevo comentario
Agregación y uso de datos de actividad
- Se puede contar la cantidad de issues y comentarios creados en GitHub mediante una consulta GraphQL
{
viewer {
issueComments {
totalCount
}
issues {
totalCount
}
}
}
- El resultado real fue 9,413 issues, 39,087 comentarios y un total combinado de 48,500
Conclusión
- GitHub Issues destaca en precio, colaboración, automatización, búsqueda, escalabilidad y versatilidad
- Si mejorara solo la sincronización offline, sería en la práctica la mejor solución de cuaderno digital
1 comentarios
Opiniones en Hacker News
Alguien compartió que, cuando estaba preparando su boda, usó GitHub Issues como herramienta de gestión de proyectos. Al principio su esposa tenía dudas, pero como era muy fácil colaborar con etiquetas, búsquedas y demás, lograron terminar a tiempo las tareas de la boda. Recuerda que la parte más difícil fue crear un marcador con un enlace directo al rastreador de issues. Más recientemente, también usó GitHub Issues para organizar cajas durante una mudanza. Creó un issue por cada caja, escribió en la descripción lo que contenía, y dejó anotado en la caja el número del issue; luego podía buscar en GitHub y encontrar fácilmente qué había en cada caja
Preguntan por curiosidad si probó alguna otra solución y por qué no le funcionó bien
Surge la duda sencilla de si no bastaría con escribir directamente el contenido en el exterior de la caja
Esto recordó a alguien una historia sobre un proyecto de reparación de una casa que vio en Hacker News. Parece que ya no está en GitHub, pero comparten el enlace al proyecto
En un trabajo anterior intentaron usar GitLab como herramienta integral de gestión de proyectos, pero la adopción se frenó porque no tenía referencias entre proyectos. Les parecía adecuado para proyectos open source, pero en su empresa actual GitLab sí puede reemplazar a YouTrack, y ya también reemplazó a Upsource
A alguien le recordó la tira xkcd 1172. Dicen que hay muchas anécdotas graciosas como esta y bastante gente con flujos de trabajo absurdos. En general, siempre es mejor resolver estas cosas con una herramienta adecuada. Como referencia, menciona que una vez organizó una mudanza internacional usando Org mode. Además, no tolera en absoluto entregar datos personales a Microsoft
Comparten un dato curioso. Si pegas la siguiente consulta GraphQL en el GitHub GraphQL Explorer, puedes ver de inmediato el total de issues y comentarios que has publicado en GitHub
Esa persona lleva 9,413 issues y 39,087 comentarios, para un total de 48,500
Esperaban que el primer comentario fuera sobre privacidad, pero curiosamente no fue así. Aunque no deja muchas notas, considera que estos datos son incluso más personales que el correo electrónico. No le gustaría que se usaran para entrenar LLM. También se pregunta qué garantías ofrece Microsoft sobre la privacidad de los private repository
Suponen que, dado que en GitHub Issues hay muchísimos secretos corporativos extremadamente sensibles, la seguridad y la privacidad deben de ser muy sólidas. Muchas empresas pagan mucho dinero a GitHub para alojar código fuente y artefactos relacionados, así que construir confianza es parte central de su modelo de negocio. Opinan que no se arriesgarían a entrenar modelos con secretos internos de sus clientes
Sobre la pregunta de si “Microsoft garantiza la privacidad de los private repository”, comparten una discusión relacionada aquí
Ponen en duda la afirmación de que “la búsqueda de GitHub es excelente”. Por ejemplo, aunque exista un comentario con la frase exacta “current logs could do with a bit of redesign”, solo se encuentra si se pone entre comillas, y además un error tipográfico como “redesing” hace que falle la búsqueda
Igual que le pasa a mucha gente, ha intentado encontrar la mejor app de notas y siempre termina volviendo a acumular archivos Markdown en un repositorio Git
Si se quiere seguir con ese enfoque, alguien comparte que la combinación de Obsidian + Git Plugin fue lo mejor que probó. En desktop funciona de maravilla, aunque en iOS requiere algo de configuración
Sugieren probar una app de notas gratis y open source. Aclaran que son clientes del desarrollador y presentan em como una app de notas hermosa y minimalista para organizar el pensamiento personal
Frente a apps con sincronización automática bidireccional en todos los dispositivos, el enfoque de hacer commit/push/pull manualmente para cada nota nueva o editada les parece anticuado
A esa persona le pasa lo mismo, pero usa archivos Org-mode en lugar de Markdown y añade poco a poco etiquetas de org-roam cuando las necesita
Comparten lo doloroso que es ir y venir entre Apple Notes y una carpeta de Markdown. La carpeta Markdown tiene mejor compatibilidad futura, pero Apple Notes destaca en diseño, simplicidad y soporte multimedia. Cuantas más funciones añade una app de Markdown, más cerrada se vuelve, y las apps de lectura también tienen que soportar todas esas funciones. Al final decidió quedarse en Apple Notes, pero una vez más está haciendo la migración manual con Obsidian hacia una carpeta Markdown. Usó la exportación, pero el formato salió hecho un desastre y ahora tiene que corregir todas las notas
Con la opción “keep downloaded” de iCloud, ahora es posible guardar localmente todas las carpetas y archivos. Como resultado, cualquier app que guarde archivos en iCloud puede ofrecer tanto trabajo offline como sincronización automática online
Preguntan cómo maneja los conflictos de sincronización y cuál es el intervalo de sincronización
También preguntan si al mover carpetas iCloud todavía usa el método de descargar y luego volver a subir
Mencionan como alternativas usar Codeberg para evitar el vendor lock-in o alojar Forgejo por cuenta propia
Consideran que GitHub Issues es el mejor bug tracker/sistema de tickets. Elogian que la interfaz sea intuitiva, simple y rápida. Eso sí, les preocupa un poco que un rediseño de Microsoft lo arruine
Otra persona comenta que, aunque ha usado varios rastreadores de issues en el trabajo, siente que a GitHub le faltan algunas funciones importantes. En concreto, no se puede escribir un resumen del issue separado de los comentarios, faltan controles de acceso avanzados (por ejemplo, permitir que solo ciertas personas vean determinados issues), y no existe una función para añadir notas privadas temporales en vez de comentarios públicos
Describen Azure DevOps de forma metafórica como un “pozo gravitacional” cuyo propósito es impedir que la filosofía de marketing de Microsoft sea absorbida por GitHub
También señalan que la apertura ya se ha reducido, con muros de inicio de sesión y límites cada vez más rápidos en la cantidad de issues que se pueden buscar
Lamentan que no exista federación. Creen que la centralización de enormes repositorios de código es una estructura que toda la comunidad de desarrolladores debería evitar. La función de merge requests federados de GitLab (issue relacionado) lleva 9 años sin novedades. Si existiera, todos podrían colaborar como con git sin depender de un sistema centralizado. También mencionan el caso reciente en que Microsoft bloqueó la cuenta de correo del fiscal jefe de la Corte Penal Internacional por orden del gobierno de Estados Unidos. Resulta irónico porque eso ocurrió poco después de que la empresa se promocionara diciendo que se enfrentaría a la Unión Europea. Dado que Trump no soporta a la UE, advierten que algún día podría ordenar a Microsoft bloquear el acceso de la UE a GitHub, y Microsoft sí tendría la capacidad de hacerlo. Piden pensar seriamente en el impacto que algo así tendría tanto para los negocios como para el open source
Opinan que, así como la confiabilidad de la tecnología china genera preocupación, ahora también se ha vuelto inestable la confianza en la tecnología estadounidense, así que las instituciones públicas y los gobiernos deben reconsiderar seriamente su dependencia tecnológica de un solo país
A alguien le gustaría probar alternativas como Radicle. Cree que si espera a que la situación empeore más para recién empezar, luego va a arrepentirse
Les parece casi igual a Obsidian, pero con un poco más de proceso
Bromean con que uno de esos pasos podría ser “pagar $50 al año para acceder desde todos los dispositivos” o “pagar $100 al año para acceder desde la web”
En realidad, dicen que Obsidian también se siente como un poco más de proceso sobre archivos de texto. Aun así, los archivos de texto en sí mismos son muy poderosos, y existen varias formas de sincronizarlos entre dispositivos
A diferencia de Obsidian, GitHub Issues es solo online. Si no se puede respaldar, eso sí sería claramente un problema
Se preguntan si sería posible autoalojar Obsidian. Para uso laboral les preocupa la seguridad, así que proponen dejarlo solo en local y respaldar únicamente los archivos Markdown con OneDrive