Einleitung

Warum dieser Abschnitt?¶

Gegen Ende des Jahres 2024 wurde deutlich, dass nicht jedes Dokument im Rocky Linux-Dokumentationscache eine Anleitung sein wird. Wir brauchten einen Platz für längere, ausführlichere Erklärungen. Beteiligen Sie sich an diesem Blog.

Wer darf hier mitmachen?¶

Jeder, der über GitHub-Zugangsdaten verfügt, kann hier einen Artikel vorschlagen. Sehen Sie sich die Dokumente im Abschnitt „Beitragen“ an, um zu beginnen.

Wenn Sie über keine GitHub-Zugangsdaten verfügen und trotzdem etwas für diesen Abschnitt schreiben möchten, kontaktieren Sie uns über den Mattermost-Kanal-Link unten auf dieser Seite.

Sie sollten sicherstellen, dass Ihr Dokument die Anforderungen für diesen Abschnitt erfüllt. Zum Beispiel:

• Passt das hierher? Sind es Informationen, die es wert sind, geteilt zu werden? Ist es ein Dokument im Blog-Stil?
• Geht es auf ein für technische Autoren wichtiges Thema ein?
• Wird die Einreichung die Qualität der Rocky Linux-Dokumentation im ganzen verbessern?

Welche Art von Information?¶

Die ersten beiden Dokumente hier sollen Ihnen eine Vorstellung davon vermitteln, was passend ist. Im Laufe des Jahres 2024 haben wir konzertierte Anstrengungen unternommen, um die Passivform in den Anleitungen zu eliminieren oder drastisch zu reduzieren. Das Dokument Aktivsprache: Der Weg zu einfacher, klarer Kommunikation beschreibt die Bedeutung der Aktivsprache im Ton der Dokumentation, die einfache Lesbarkeit und Verständlichkeit sowie die Vereinfachung der Übersetzung in andere Sprachen. Das Dokument Open Source: Warum nie ein Bindestrich verwendet wird befasst sich mit der großen Debatte zu diesem Thema und den Gründen für unsere Entscheidung, keinen Bindestrich zu verwenden. Alles klar? Hierbei handelt es sich um informative Dokumente, die keine Anleitungen enthalten, außer vielleicht als Beispiele.

Entwicklung dieses Blogs?¶

Die Ansammlung von Dokumenten dieser Art wird wahrscheinlich langsamer wachsen als die Anleitung-Dokumente. Das ist so wie erwartet. Entscheidend sind vor allem die Qualität und Relevanz der Dokumente.

Rückmeldungen und Feedback¶

Wie beim gesamten Dokumentationsprojekt können Sie in unserem Documentation Mattermost-Kanal Feedback geben.

Author: Steven Spencer