Saltar al contenido principal

Actualizando la Base de conocimientos

El objetivo de la base de conocimientos de AdGuard Ad Blocker es brindar a todos la información más actualizada sobre todo tipo de temas relacionados con AdGuard. Pero las cosas cambian constantemente y, a veces, un artículo ya no refleja el estado actual de las cosas.

Por eso hemos colocado todo el contenido de nuestra base de conocimiento en GitHub, y ahora, literalmente, cualquiera puede contribuir a ella sugiriendo modificaciones y traducciones de los artículos existentes, así como otros totalmente nuevos.

Cómo sugerir un cambio o redactar un nuevo artículo

Puedes sugerir cambios a los artículos actuales y agregar otros nuevos a nuestra base de conocimientos utilizando la funcionalidad de GitHub mencionada anteriormente. Si no estás familiarizado con los principios de trabajo con la plataforma, comienza leyendo la documentación de GitHub.

Una vez que estés listo para comenzar, trabaja en el repositorio KnowledgeBase. Todos los textos de nuestra Base de conocimientos están escritos en lenguaje de marcado Markdown. Tenlo en cuenta cuando edites o escribas artículos. Sigue este enlace para aprender más sobre la sintaxis de Markdown.

El sitio web de Base de conocimiento se construye utilizando Docusaurus 2 - un moderno generador de sitios web estáticos. Al sugerir cambios o adiciones, ten en cuenta que todos los documentos deben cumplir con los principios de la plataforma. Puedes leer sobre ellos en Guías de Docusaurus.

Puedes implementar esta base de conocimiento localmente en tu computadora para obtener una vista previa de los cambios que sugiere. Puede encontrar instrucciones detalladas sobre cómo hacerlo en el archivo README de la página de GitHub de esta Base de conocimientos.

Traducción de artículos

La traducción de los artículos existentes de la Base de conocimientos se realiza a través de 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.

Cuando se trabaja en los artículos de la Base de conocimientos de AdGuard, es posible que encuentres con cadenas que contienen formas plurales que debes traducir con especial atención. En un artículo separado, describimos en detalle las dificultades que pueden surgir al traducir cadenas con formas plurales, y dimos amplias instrucciones sobre cómo trabajar con ellas en la plataforma Crowdin.

Trabajar en los temas pendientes

A veces existen tareas abiertas en relación con la actualización de la Base de conocimientos. Puedes ayudarnos a acelerar su finalización del mismo modo que sugerirías cualquier otro cambio en la Base de conocimientos. Elige cualquier tema que te parezca atractivo y empieza a trabajar en él. Si tienes alguna pregunta, puedes hacerla en los comentarios de ese tema.