Обновление Базы знаний
Цель Базы знаний — предоставить пользователям актуальную информацию по всем вопросам, касающимся блокировщика AdGuard. Так как в продуктах постоянно происходят изменения, статьи часто теряют свою актуальность.
По этой причине мы переместили всё содержимое нашей Базы знаний на GitHub, и теперь буквально каждый человек может принять участие в её обновлении — редактировать и переводить существующие статьи или создавать новые.
Как предложить изменение или написать новую статью
Вы можете предлагать изменения в текущих статьях и добавлять новые статьи, используя функционал GitHub. Если вы не знакомы с принципами работы платформы, сначала ознакомьтесь с соответствующим руководством.
Работайте в репозитории KnowledgeBase. Все тексты в нашей Базе знаний написаны на языке разметки Markdown. Помните об этом при редактировании или написании статей. Перейдите по ссылке, чтобы узнать больше о синтаксисе Markdown.
Сайт Базы знаний создан с помощью Docusaurus 2 — современного генератора статических сайтов. Предлагая изменения или дополнения, вам необходимо учитывать принципы работы платформы. Вы можете прочитать о них в Docusaurus Guides.
Для предварительного просмотра предложенных изменений вы можете развернуть эту Базу знаний локально на своём компьютере. Подробную инструкцию о том, как это сделать, можно найти в файле README на странице Базы знаний на GitHub.
Переводы статей
Cуществующие статьи Базы знаний можно перевести на платформе Crowdin. Все подробности о переводах статей и работе с Crowdin можно найти в соответствующей статье Базы знаний блокировщика рекламы AdGuard.
При работе над статьями Базы знаний AdGuard вы можете встретить строки, содержащие формы множественного числа (плюральные формы). К их переводу стоит отнестись с особым вниманием. В отдельной статье мы подробно описали трудности, которые могут возникнуть при переводе таких строк, и дали исчерпывающие инструкции по работе с ними на платформе Crowdin на английском языке.
Работа над существующими задачами
Иногда появляются открытые задачи, связанные с обновлением Базы знаний. Помочь можно таким же образом, как вы предлагаете любые другие изменения в Базе знаний. Выберите любую задачу, которая кажется вам интересной, и начните работать над ней. Все возникающие вопросы вы можете задавать прямо в комментариях к задаче.