Mise à jour de la Base de connaissances
L'objectif de la Base de connaissances du Bloqueur des annonces AdGuard est de fournir à chacun les informations les plus récentes sur toutes sortes de sujets liés à AdGuard. Mais les choses évoluent constamment et il arrive qu'un article ne reflète plus l'état actuel des choses.
C'est pourquoi nous avons placé l'ensemble du contenu de notre base de données sur GitHub. Désormais, tout le monde peut y contribuer en suggérant des modifications et des traductions pour les articles existants, ainsi que de nouveaux articles.
Comment suggérer un changement ou écrire un nouvel article
Vous pouvez suggérer des modifications aux articles actuels et en ajouter de nouveaux à la Base de connaissances en utilisant la fonctionnalité de GitHub mentionné ci-dessus. Si vous n'êtes pas familier avec les principes de travail avec la plate-forme, commencez par lire la documentation GitHub.
Une fois que vous êtes prêt à commencer, procédez dans le référentiel KnowledgeBase. Tous les textes de notre Base de connaissances sont rédigés en langage de balisage Markdown
. Gardez cela à l'esprit lorsque vous modifiez ou rédigez des articles. Suivez ce lien pour apprendre plus sur la syntaxe Markdown.
Le site web de la Base de connaissances est construit à l'aide de Docusaurus 2 - un générateur moderne de sites web statiques. Lorsque vous suggérez des modifications ou des ajouts d'infos, tenez compte du fait que tous les documents doivent respecter les principes de la plateforme. Vous pouvez en prendre connaissance dans les Guides sur Docusaurus.
Vous pouvez déployer cette Base de connaissances localement sur votre ordinateur pour prévisualiser les modifications que vous suggérez. Vous trouverez des instructions détaillées sur la façon de procéder à l'adresse dans le fichier README.md sur la page GitHub de cette Base de connaissances.
La traduction des articles
La traduction des articles existants de la Base de connaissances est réalisée sur la plateforme Crowdin. Tous les détails sur les traductions et le travail avec Crowdin peuvent être trouvés dans l'article dédié de la Base de connaissances du Bloqueur AdGuard.
Lorsque vous travaillez sur des articles de la Base de connaissances de AdGuard, vous pouvez rencontrer des chaînes contenant des formes plurielles que vous devrez traduire avec une attention particulière. Dans un article séparé, nous avons décrit en détail les difficultés qui peuvent survenir lors de la traduction de chaînes avec des formes plurielles, et avons donné des instructions détaillées sur la façon de les utiliser sur la plate-forme Crowdin.
Le travail sur les questions ouvertes
Parfois, il y aura des tâches ouvertes liées à la mise à jour de la Base de connaissances. Vous pouvez nous aider à accélérer leur réalisation de la même manière que vous suggéreriez toute autre modification à cette Base de connaissances. Choisissez un sujet qui vous intéresse et commencez à travailler dessus. Si vous avez des questions, vous pouvez les poser directement dans les commentaires de cette tâche.