Transparencia y atención al usuario: el papel de GitHub en AdGuard

En AdGuard, trabajamos todos los días para hacer que Internet sea más segura, cómoda y transparente. Este compromiso se refleja no solo en las funciones de nuestros productos y en nuestras estrictas políticas de privacidad, sino también en el hecho de mantener nuestro trabajo lo más abierto posible. Esto incluye interactuar activamente con nuestra comunidad.

Es por eso que todos nuestros productos cuentan con repositorios públicos: espacios en línea donde cualquier persona puede ver en qué estamos trabajando, reportar problemas directamente a los desarrolladores de AdGuard e incluso contribuir a nuestros proyectos de código abierto. Los repositorios abarcan nuestras aplicaciones de bloqueo de anuncios, filtros, extensiones de navegador, soluciones DNS, herramientas de VPN, utilidades para desarrolladores y mucho más. Existen diferentes plataformas que ofrecen esta funcionalidad, pero la más popular con diferencia es GitHub, y todos los proyectos de AdGuard están alojados allí.

Este artículo enumera los repositorios más importantes por categoría, resume el propósito de cada uno y presenta una explicación sencilla de lo que los usuarios pueden hacer en cada espacio.

Qué es GitHub y sus repositorios

De manera muy simple, puedes pensar en GitHub como una especie de Google Docs para código, donde varias personas pueden trabajar en el mismo proyecto, dar seguimiento a los cambios y ver quién hizo cada actualización. Proporciona un lugar central en la nube para almacenar tu código, lo que lo hace accesible desde cualquier lugar. También cuenta con herramientas de colaboración para revisar cambios, corregir problemas e integrar el trabajo de todos de forma organizada.

GitHub es ampliamente utilizado para proyectos de código abierto, permitiendo que cualquier persona visualice el código, sugiera mejoras y contribuya.

Un repositorio (o “repo”, abreviación) es el elemento más básico de GitHub. Es un espacio donde puedes almacenar tu código, archivos y el historial de revisiones de cada archivo. Los repositorios pueden tener múltiples colaboradores y pueden ser públicos o privados.

Por dónde empezar

Puedes encontrar enlaces a los repositorios principales en este artículo o visitar la página general de AdGuardTeam en GitHub para ver la lista completa. En la mayoría de los repositorios, puedes:

• Ver el archivo README en la página principal: presenta el producto y su repositorio
  

• Revisar reportes de errores o solicitudes de funciones existentes, comentar y votar
  

• Crear issues para reportar errores o solicitar funciones
  

• Consultar releases para ver diferentes versiones y sus changelogs (e instalar una versión anterior si es necesario)
  

• Instalar cualquier versión anterior o beta, si es necesario
  

Nota: si eres nuevo en GitHub, necesitarás crear una cuenta para poder abrir nuevos issues y comentar en los existentes.

En los repositorios de código abierto, los usuarios avanzados también pueden:

• Explorar el código para entender la lógica del producto, las tecnologías usadas y cómo se implementan
• Hacer fork y contribuir mediante pull requests

Ya seas un usuario casual, un especialista técnico o un desarrollador, AdGuard da la bienvenida a la participación de toda la comunidad en sus repositorios de GitHub.

Productos del bloqueador de anuncios AdGuard

En estos repositorios, los usuarios pueden:

• Visualizar y reportar errores o solicitudes de funciones mediante GitHub issues
• Consultar changelogs, seguir el historial de versiones y monitorear actualizaciones
• Descargar builds más recientes, anteriores y beta (excepto para iOS)

AdguardForAndroid

Repositorio de AdGuard para Android — aplicación que proporciona bloqueo de anuncios en todo el sistema.

AdguardForiOS

Repositorio de AdGuard para iOS — bloqueador de contenido para Safari con DNS y filtros personalizados. Los usuarios también pueden revisar el código abierto.

AdguardForWindows

Repositorio de AdGuard para Windows. No es de código abierto; GitHub se usa únicamente como rastreador de errores abierto.

AdguardForMac

Repositorio de AdGuard para Mac — bloqueador de contenido independiente para macOS. Solo funciona como rastreador de errores.

AdguardBrowserExtension

Repositorio de AdGuard Browser Extension — extensión que proporciona bloqueo de anuncios con mayor privacidad para Chrome, Firefox, Opera y Edge.

AdguardForSafari

Repositorio de AdGuard para Safari — extensión de bloqueo de anuncios para Safari en Mac. Los usuarios también pueden revisar el código abierto.

AdGuardCLI

Repositorio de AdGuard para Linux — interfaz de línea de comandos para administrar el bloqueo de anuncios.

Productos AdGuard VPN

En estos repositorios, los usuarios pueden:

• Visualizar y reportar errores o solicitudes de funciones mediante GitHub issues
• Consultar changelogs, seguir el historial de versiones y monitorear actualizaciones
• Descargar builds más recientes, anteriores y beta (excepto para iOS)

AdGuardVPNForiOS

Repositorio de AdGuard VPN para iOS. Funciona como rastreador abierto de errores.

AdGuardVPNForAndroid

Repositorio de AdGuard VPN para Android. Funciona como rastreador abierto de errores.

AdGuardVPNForWindows

Repositorio de AdGuard VPN para Windows. Funciona como rastreador abierto de errores.

AdGuardVPNForMac

Repositorio de AdGuard VPN para Mac — aplicación desarrollada para macOS.

AdGuardVPNExtension

Repositorio de la extensión AdGuard VPN para navegadores.

AdGuardVPNCLI

Repositorio de AdGuard VPN para Linux — interfaz de línea de comandos para gestionar la conexión VPN. El repositorio funciona como rastreador de errores.

Productos de DNS

AdGuardDNS

Repositorio de código abierto usado también para rastrear errores y problemas relacionados con el servicio AdGuard DNS. Los usuarios pueden:

• Visualizar y reportar problemas de DNS
• Sugerir mejoras

AdGuardHome

Repositorio de AdGuard Home — software gratuito para toda la red que bloquea anuncios y rastreadores vía DNS. Los usuarios pueden:

• Revisar y enviar reportes de errores o solicitudes de funciones
• Revisar o contribuir al código
• Descargar e instalar releases

Documentación y bases de conocimiento

Las bases de conocimiento ayudan a los usuarios a entender mejor y utilizar AdGuard. Describen cada producto en detalle: desde una visión general de las funciones y guías de solución de problemas hasta manuales avanzados y documentación de APIs. En los repositorios, los usuarios pueden:

• Sugerir correcciones o ediciones en los artículos de la base de conocimiento
• Proponer nuevos artículos
• Probar o ejecutar la versión local

KnowledgeBase

Documentación central de AdGuard Ad Blocker y tecnologías relacionadas.

KnowledgeBaseDNS

Vista detallada de las funciones, guías de solución de problemas y documentación de AdGuard DNS (público y privado), AdGuard Home y todo lo relacionado.

KnowledgeBaseVPN

Vista detallada de las funciones y guías de solución de problemas de AdGuard VPN.

KnowledgeBaseMail

Vista detallada de las funciones y guías de solución de problemas de AdGuard Mail.

Bibliotecas principales

AdGuardCoreLibs

Motor de filtrado multiplataforma de AdGuard, usado en productos Android, Windows y Mac. Los usuarios pueden:

• Explorar la lógica de filtrado y la gestión de DNS
• Reportar errores y sugerir funciones mediante issues, contribuir con código mediante pull requests

DNSLibs

Biblioteca de DNS usada por CoreLibs y AdGuard Home. Los usuarios pueden:

• Revisar y contribuir a la implementación de bajo nivel de DNS
• Sugerir optimizaciones

VPNLibs

Base de código compartida usada en los productos AdGuard VPN para implementar el protocolo AdGuard VPN. Los usuarios pueden:

• Contribuir al comportamiento de la pila VPN
• Reportar o revisar problemas de rendimiento y errores

Tecnologías principales de bloqueo de anuncios y filtrado

AdguardFilters

Contiene las listas de filtros principales de AdGuard. Los usuarios pueden:

• Visualizar y descargar listas de filtros
• Crear issues para reportar falsos positivos o sugerir nuevas reglas
• Seguir actualizaciones en la lógica de filtrado

AdGuardSDNSFilter

Repositorio del filtro DNS de AdGuard — lista principal de bloqueo a nivel DNS usada en AdGuard DNS y funciones de filtrado DNS. Los usuarios pueden:

• Inspeccionar el conjunto de reglas actual
• Proponer cambios o adiciones

AGLint

Linter para sintaxis de listas de filtros de adblock. Los usuarios pueden:

• Instalar AGLint para verificar problemas en sus listas
• Contribuir con reglas de lint

Scriptlets

Helpers en JavaScript usados en las reglas de filtrado. Los usuarios pueden:

• Explorar los scriptlets disponibles
• Enviar pull requests para nuevos scriptlets

tsurlfilter

Biblioteca en TypeScript para bloqueo de contenido en extensiones de navegador. Los usuarios pueden:

• Explorar cómo se implementa la lógica de filtrado
• Contribuir con correcciones y nuevas funciones

Hay más

Arriba listamos 27 repositorios públicos principales de AdGuard, de un total de 96. Si quieres explorar más, puedes encontrar el resto en la página de AdGuardTeam en GitHub.

¡Esperamos tus comentarios ahí! Mantente seguro en línea y fuera de línea.