Wissensdatenbanken aktualisieren
Das Ziel der AdGuard-Werbeblocker-Wissensdatenbank ist es, jedem die aktuellsten Informationen zu allen Arten von AdGuard-bezogenen Themen zur Verfügung zu stellen. Aber die Dinge ändern sich ständig, und manchmal spiegelt ein Artikel nicht mehr den aktuellen Stand der Dinge wider.
Aus diesem Grund haben wir alle Inhalte unserer Wissensdatenbank auf GitHub eingestellt, und jetzt kann buchstäblich jeder dazu beitragen, indem er/sie Bearbeitungen und Übersetzungen zu bestehenden Artikeln vorschlägt, aber auch völlig neue Artikel erstellt.
Änderungen vorschlagen / einen neuen Artikel schreiben
Sie können Änderungen an aktuellen Artikeln vorschlagen und neue zu unserer Wissensdatenbank hinzufügen, indem Sie die oben erwähnte Funktionalität von GitHub verwenden. Wenn Sie mit den Prinzipien der Arbeit mit der Plattform nicht vertraut sind, lesen Sie zunächst GitHub-Dokumentation.
Sobald Sie startbereit sind, arbeiten Sie im KnowledgeBase-Repository. Alle Texte in unserer Wissensdatenbank sind in Markdown Auszeichnungssprache geschrieben. Befolgen Sie die Markdown-Regeln, wenn Sie Artikel bearbeiten oder schreiben. Folgen Sie diesem Link, um mehr über die Markdown-Syntax zu erfahren.
Die Website der Wissensdatenbank wurde mit Docusaurus 2 erstellt, einem modernen Generator für statische Websites. Wenn Sie Änderungen oder Ergänzungen vorschlagen, beachten Sie bitte, dass alle Dokumente den Grundsätzen der Plattform entsprechen müssen. Sie können über sie in Docusaurus Guides lesen.
Sie können die Wissensdatenbank auch lokal auf Ihrem Computer bereitstellen, um eine Vorschau auf die von Ihnen vorgeschlagenen Änderungen zu erhalten. Detaillierte Anweisungen dazu finden Sie in der README-Datei auf der GitHub-Seite dieser Wissensdatenbank.
Artikel übersetzen
Die Übersetzung der bestehenden Artikel der Wissensdatenbank erfolgt auf der Crowdin-Plattform. Alle Details zu Übersetzungen und zur Arbeit mit Crowdin finden Sie im entsprechenden Artikel der Wissensdatenbank von AdGuard Werbeblocker.
Wenn Sie an Artikeln der AdGuard-Wissensdatenbank arbeiten, stoßen Sie möglicherweise auf Strings mit Pluralformen, die Sie mit besonderer Aufmerksamkeit übersetzen sollten. In einem separaten Artikel haben wir ausführlich die Schwierigkeiten beschrieben, die beim Übersetzen von Strings mit Pluralformen auftreten können, und eine ausführliche Anleitung gegeben, wie man damit auf der Crowdin-Plattform arbeiten kann.
An Open Issues arbeiten
Manchmal gibt es offene Probleme (open issues) auf GitHub im Zusammenhang mit der Aktualisierung der Wissensdatenbank. Sie können uns dabei helfen, die Fertigstellung zu beschleunigen genauso wie Sie andere Änderungen an der Wissensdatenbank vorschlagen würden. Wählen Sie ein beliebiges Thema, das Sie ansprechend finden, und beginnen Sie, daran zu arbeiten. Wenn Sie Fragen haben, können Sie diese direkt in den Kommentaren zum Problem stellen.