ナレッジベースの更新・変更

このナレッジベース（知恵袋）の目的は、AdGuard VPN関連のあらゆるトピックに関する最新情報を皆様に提供することです。 しかし、物事は常に変化しており、時には記事が現在の状態を反映していないことがあります。しかし、すべての情報を把握し、新しいバージョンが出たときにそれを更新できるほど、現在私たちは多人数ではなく、一部情報更新には遅れが発生することがあります。

そのため、私たちはすべてのナレッジベースコンテンツをGitHubに置き、既存の記事の編集や翻訳、まったく新しい記事の提案など、誰もが貢献できるようにしました。

変更点を提案する・新しい記事を書く方法

上記のGitHubの機能を使って、現在の記事の変更を提案したり、新しい記事をナレッジベースに追加することができます。 GitHubプラットフォームでの作業に慣れていない場合は、こちらのGitHubの使い方に関するドキュメントを確認することから始めてください。

準備ができたら、KnowledgeBaseVPNリポジトリで作業してください。 ナレッジベースにあるすべてのテキストは、 Markdownマークアップ言語で書かれています。 記事の編集や執筆の際には、このことを念頭に置いてください。 こちらで、Markdownの構文について詳しく知ることができます。

ナレッジベースのウェブサイトは、現代の静的ウェブサイトジェネレータである「Docusaurus 2」を使用して構築されています。 変更または追加を提案する場合、すべてのテキストがのDocusaurus 2に準拠している必要があります。 Docusaurus 2の原則は、 このリンク先のガイドで確認することができます。

このナレッジベースは、お使いのコンピュータにローカルに展開し、提案する変更をプレビューすることができます。 この方法の詳細な説明は in the README.md file Knowledge BaseのGitHubページで閲覧できます。

記事の翻訳

ナレッジベースの既存記事の翻訳は、 Crowdin platformを使って行われています。 翻訳、またCrowdinの使い方はAdGuard Ad Blocked Knowledge Base内の専用ページにて閲覧できます。

AdGuard VPN ナレッジベースの記事を翻訳する際、複数形を含む文字列に遭遇することがありますが、複数形がいっぱいある言語の場合は特に注意して翻訳してください。 In a separate article, we describe in detail the difficulties that can arise when translating strings with plural forms and provide detailed guidance on how these are handled on the Crowdin platform.

Open issue（GitHub）の作業

ナレッジベースの更新に関連するオープンタスクが存在することがあります。 このナレッジベースに対する他の変更を提案するのと同じ方法で、タスクの完了を早くすることができます。 お好みのタスクを選んで、ぜひ作業を始めてください。 issueに関してご質問があれば、issueのコメント欄で直接お知らせください。