Atualizando a Base de Conhecimento
O objetivo desta Base de conhecimento é fornecer a todos as informações mais atualizadas sobre todos os tipos de tópicos relacionados ao AdGuard DNS. Mas as coisas mudam constantemente e, às vezes, um artigo não reflete mais o estado atual das coisas - simplesmente não há muitos de nós para ficar de olho em cada informação e atualizá-la de acordo quando novas versões são lançadas.
É por isso que colocamos todo o nosso conteúdo da KB no GitHub, e agora literalmente qualquer pessoa pode contribuir sugerindo edições e traduções de artigos existentes, bem como de artigos totalmente novos.
Como sugerir uma mudança ou escrever um novo artigo
Você pode sugerir alterações nos artigos atuais e adicionar novos à Base de Conhecimento usando a funcionalidade do GitHub mencionada acima. Se você não estiver familiarizado com os princípios de trabalho com a plataforma, comece lendo a documentação nesta seção.
Quando estiver pronto para começar, trabalhe com o repositório KnowledgeBaseDNS. Todos os textos em nossa Base de Conhecimento são escritos em linguagem de marcação Markdown. Tenha isso em mente ao editar ou escrever artigos. Siga este link para saber mais sobre a sintaxe do Markdown.
O site da Base de Conhecimento é construído usando o Docusaurus 2 — um moderno gerador de sites estáticos. Ao sugerir alterações ou acréscimos, leve em consideração que todos os documentos devem obedecer aos princípios da plataforma. You can read about them in this guide.
Você pode implantar esta Base de Conhecimento localmente em seu computador para visualizar as alterações sugeridas. Instruções detalhadas sobre como fazer isso podem ser encontradas no arquivo README.md na página GitHub desta Base de Conhecimento.
Traduzindo artigos
A tradução dos artigos existentes da Base de Conhecimento é realizada na plataforma Crowdin. All the details about translations and working with Crowdin can be found in the dedicated article of the AdGuard Ad Blocker Knowledge Base.
Ao trabalhar em artigos da Base de Conhecimento de AdGuard DNS, você pode encontrar strings contendo formas plurais que devem ser traduzidas com atenção extra. In a separate article, we describe in detail the difficulties that can arise when translating strings with plural forms, and provide extensive instructions on how to work with them on the Crowdin platform.
Trabalhando em problemas abertos
Às vezes, existem tarefas abertas relacionadas à atualização da Base de Conhecimento. Você pode nos ajudar a acelerar sua conclusão da mesma forma que você sugeriria quaisquer outras alterações nesta Base de Conhecimento. Escolha qualquer problema que você achar atraente e comece a trabalhar nele. Se você tiver alguma dúvida - você pode perguntar diretamente nos comentários dessa edição.