Actualizando la base de conocimientos
El objetivo de esta base de conocimientos es proporcionar a todos la información más actualizada sobre todo tipo de temas relacionados con AdGuard VPN. Pero las cosas cambian constantemente, y a veces un artículo ya no refleja el estado actual de las cosas: simplemente no somos muchos los que vigilamos cada bit de información y la actualizamos en consecuencia cuando se lanzan nuevas versiones.
Es por eso que colocamos todo nuestro contenido de base de conocimientos en GitHub y ahora, literalmente, cualquiera puede contribuir sugiriendo ediciones y traducciones de artículos existentes, así como también de artículos totalmente nuevos.
Cómo sugerir un cambio o escribir un nuevo artículo
Puede sugerir cambios en los artículos actuales y agregar otros nuevos a la Base de conocimientos utilizando la funcionalidad de GitHub mencionada anteriormente. Si no está familiarizado con los principios de trabajo con la plataforma, comience leyendo documentación en esta sección.
Una vez que esté listo para comenzar, trabaje en el repositorio de KnowledgeBaseVPN. Todos los textos de nuestra base de conocimientos están escritos en lenguaje de marcado Markdown. Tenga esto en cuenta al editar o escribir artículos. Siga este enlace para obtener más información sobre la sintaxis de Markdown.
El sitio web de Knowledge Base está construido con Docusaurus 2, un moderno generador de sitios web estáticos. Al sugerir cambios o adiciones, tenga en cuenta que todos los documentos deben cumplir con los principios de la plataforma. Puede leer sobre ellos en la guía disponible a través de este enlace.
Puede implementar esta base de conocimientos localmente en el equipo para obtener una vista previa de los cambios que sugiera. Detailed instructions on how to do this can be found in the README.md file on this Knowledge Base's GitHub page.
Traducción de artículos
La traducción de los artículos existentes de la Base de conocimiento se lleva a cabo en la plataforma Crowdin. Todos los detalles sobre las traducciones y el trabajo con Crowdin se pueden consultar en el artículo dedicado de la Base de conocimientos del bloqueador de anuncios AdGuard.
Al trabajar en artículos de la base de conocimiento de AdGuard VPN, puede encontrar cadenas que contengan formularios plurales que debe traducir con especial atención. In a separate article, we describe in detail the difficulties that can arise when translating strings with plural forms and provide detailed guidance on how these are handled on the Crowdin platform.
Trabajando en problemas abiertos
A veces existen tareas abiertas relacionadas con la actualización de la Base de conocimientos. Puede ayudarnos a acelerar su finalización la misma manera sugeriría cualquier otro cambio en esta Base de conocimiento. Elija cualquier problema que le resulte atractivo y comience a trabajar en él. Si tiene alguna pregunta, puede hacerla directamente en los comentarios de ese problema.