Diese Seite enthält die Details eines Projekts für technisches Schreiben, das für die Google-Staffel von Google Docs akzeptiert wurde.
Projektzusammenfassung
- Open-Source-Organisation:
- Apache Cassandra
- Technischer Redakteur:
- Dvohra
- Projektname:
- Dokumentation zu Apache Cassandra 4.0 aktualisieren und Aufgaben in der Dokumentation beheben
- Projektdauer:
- Lange Ausführung (5 Monate)
Projektbeschreibung
Das Projekt besteht aus zwei Unterprojekten:
1. Aktualisierung der Dokumentation zu Apache Cassandra 4.0
Prüfen und aktualisieren Sie die vorhandene Apache Cassandra-Dokumentation, um sicherzustellen, dass sie
mit dem anstehenden Apache Cassandra 4.0-Release übereinstimmt. Unser vorgeschlagener
Ansatz dafür wäre, zuerst die
-Mailingliste „cassandra-dev“ für Cassandra-Mitwirkende aufzurufen und die Bereiche des Dokuments hervorzuheben,
die aktualisiert werden müssen. Zweitens erstellen wir eine strukturierte
Überprüfung der vorhandenen Dokumentation, um potenzielle Lücken zu ermitteln. Beispiel:
In der strukturierten Rezension könnte der technische Redakteur die
Dokumentation zur Cassandra-Konfigurationsdatei
(http://cassandra.apache.org/doc/latest/configuration/cassandra_config_file.html) mit den Konfigurationsoptionen vergleichen, die tatsächlich in der Quelle enthalten sind
(https://github.com/apache/cassandra/blob/trunk/src/java/org/apache/cassandra/config/Config.java
2. AUFGABEN in der Apache Cassandra-Dokumentation auflösen
Die Apache Cassandra-Dokumentation enthält eine Reihe von Abschnitten,
die als „TODO“ (oder noch zu erledigende Aufgaben) markiert sind. Diese sind:
- Betrieb von Cassandra / Back-ups
- Cassandra-Betrieb / Massenladevorgänge
- CQL-/Datendefinitionen (eingeschränkte Prüfpunkte)
- Datenmodellierung
- Dynamo / Klatsch, Fehlererkennung und Token Ring
- Architektur/Garantien
- Betriebs-Cassandra/Hints
- Architektur/Überblick (wird als separates Projekt vorgeschlagen)
- Cassandra-/Lese-Reparatur
- Viele Mitglieder der Community haben Material zu diesen Themen erstellt, darunter öffentliche Blogposts, Stack Overflow-Beiträge usw. Der produktivste Ansatz zum Ausfüllen dieser Abschnitte könnte darin bestehen, gute Referenzen und Material von den Mailinglisten anzufordern und in ein prägnantes Dokument der Apache Cassandra-Dokumentation zu synthetisieren.