Перейти к основному содержанию

Обновление Базы знаний

Цель Базы знаний — предоставить пользователям актуальную информацию по всем вопросам, касающимся блокировщика AdGuard. Так как в продуктах постоянно происходят изменения, статьи часто теряют свою актуальность.

По этой причине мы переместили всё содержимое нашей Базы знаний на GitHub, и теперь буквально каждый человек может принять участие в её обновлении — редактировать и переводить существующие статьи или создавать новые.

Как предложить изменение или написать новую статью

Вы можете предлагать изменения в текущих статьях и добавлять новые статьи, используя функционал GitHub. Если вы не знакомы с принципами работы платформы, сначала ознакомьтесь с соответствующим руководством.

Работайте в репозитории KnowledgeBase. Все тексты в нашей Базе знаний написаны на языке разметки Markdown. Помните об этом при редактировании или написании статей. Перейдите по ссылке, чтобы узнать больше о синтаксисе Markdown.

Сайт Базы знаний создан с помощью Docusaurus 2 — современного генератора статических сайтов. Предлагая изменения или дополнения, вам необходимо учитывать принципы работы платформы. Вы можете прочитать о них в Docusaurus Guides.

Для предварительного просмотра предложенных изменений вы можете развернуть эту Базу знаний локально на своём компьютере. Подробную инструкцию о том, как это сделать, можно найти в файле README на странице Базы знаний на GitHub.

Переводы статей

Cуществующие статьи Базы знаний можно перевести на платформе Crowdin. Все подробности о переводах статей и работе с Crowdin можно найти в соответствующей статье Базы знаний блокировщика рекламы AdGuard.

При работе над статьями Базы знаний AdGuard вы можете встретить строки, содержащие формы множественного числа (плюральные формы). К их переводу стоит отнестись с особым вниманием. В отдельной статье мы подробно описали трудности, которые могут возникнуть при переводе таких строк, и дали исчерпывающие инструкции по работе с ними на платформе Crowdin на английском языке.

Работа над существующими задачами

Помимо написания и перевода статей, вы можете поработать над открытыми задачами, связанными с обновлением данной Базы знаний. Помочь можно таким же образом , как вы предлагаете любые другие изменения в Базе знаний. Выберите любую задачу, которая кажется вам интересной, и начните работать над ней. Все возникающие вопросы вы можете задавать прямо в комментариях к задаче.