Wie werde ich ein BlueSpice Hacker?

Dieser Artikel soll Entwicklern helfen, die notwendigen Fähigkeiten zu erwerben, um zur BlueSpice-Entwicklung beitragen zu können.

Warum solltest Du mitmachen?
Wenn Du Dich aktiv im Projekt beteiligst, hast Du die Chance dieses mitzugestalten. Ganz nach dem Motto "Veränderungen entstehen vor allem durch "Machen"", kannst Du Dich also einbringen. Großer Dank ist Dir sowieso sicher, aber selbstverständlich wird auch Dein Name in Bezug auf Deine jeweilige Mitarbeit öffentlich genannt. Ganz abgesehen davon, dass Du nicht nur uns, sondern den vielen Nutzern da draußen hilfst, die Dir ein Stilles oder Lautes Danke zukommen lassen.

Mitmachen

Wie in allen Projekten gibt es die unterschiedlichsten Arten, wie Du Dich beteiligen kannst. Hier einige Beispiele wie Du Teil des BlueSpice-Projektes werden kannst.

Verbesserung der Code Qualität

• Docblöcke: Schreibe mit uns Dokumentationsblöcke im Quellcode. Du hilfst damit den Code zu vervollständigen und Unstimmigkeiten aufzudecken. Mehr zu den MediaWiki DocBlocks bei wikimedia.
• Coding conventions: Hilf mit die Coding Conventions durchzusetzen. Wir nutzen dazu die Coding Conventions von MediaWiki.
• Sicherheit: Sicherheit wird bei uns groß geschrieben. Wenn Du möchtest kannst Du helfen, diese weiter zu verbessern. Dazu solltest Du dich an die Empfehlungen für die Sicherheit für Entwickler halten.

Bugfixes

Du kannst Ausschau halten nach kleineren und größeren Bugs. Wenn Dir nicht nur ein Bug auffällt, sondern Du auch gleich die Lösung programmiert hat - umso besser!
Hier eine Hilfestellung zum Debugging in MediaWiki

Code Review

Hilf uns Entwicklungen zu bewerten. Dazu musst Du Dich in gerrit auskennen. Mehr dazu findest Du unter dem Punkt "Entwicklungsumgebung aufsetzen" und "Änderungen einchecken".

• BlueSpice Extensions
• BlueSpice Foundation
• BlueSpice Skin

Kleine Ergänzungen

Viele der existierenden Extensions bieten sich an, um weiterentwickelt zu werden und erweiterte Funktionalitäten anzubieten. Ganz konkret haben wir dafür im Kopf:
Dashboard Widgets, Statistiken, Sidebar Widgets, etc.

Eigene Erweiterungen

Du kannst natürlich auch eigene Erweiterungen für BlueSpice schreiben. Bitte halte dazu den MediaWiki Workflow ein. Auf den MediaWiki Seiten findest Du ausführliche Hinweise wie Du eine eigene MediaWiki Extension entwickelst und was Du dazu beachten solltest. Diese Hinweise gelten auch für BlueSpice. Bitte lege für eigene Erweiterungen in gerrit ein eigenes Verzeichnis an, das wie folgt benannt ist:

mediawiki/skins/BlueSpiceDeine Erweiterung

Übersetzungen

Übersetzungen werden natürlich jederzeit gebraucht. Bitte wende Dich dazu an die Community von translatewiki.net. Einen Überblick findest Du auf unserer dortigen Projektseite.

Und so läuft das Ganze ab

Änderungen einchecken

Du hast zwei Möglichkeiten Deine Patches einzubringen.

1. E-Mail an Hallo Welt!

Sende eine E-Mail mit Deinem Patch (git format-patch) an support@hallowelt.com. Wir checken dann die Änderung für Dich im Git-System ein, wo es den üblichen Prozess durchläuft.

2. Aktiv Mitmachen über das Git

Wir folgen hier genau dem Prozedere, das auch für die Beteiligung an der MediaWiki-Entwicklung vorgesehen ist:

• Entwickler-Account bei MediaWiki holen
• Git-review installieren
• Code von BlueSpice auschecken
• Änderungen vornehmen und einchecken
• Änderungen werden in Gerrit gegengeprüft
• Sobald alles passt, werden die Änderungen übernommen

Auf MediaWiki.org findet sich dazu auch eine kurze und eine ausführliche Anleitung.

Der Code von BlueSpice befindet sich in den folgenden Repositories:

mediawiki/extensions/BlueSpiceFoundation.git
mediawiki/extensions/BlueSpiceExtensions.git
mediawiki/skins/BlueSpiceSkin.git

und kann so ausgecheckt werden:

git clone ssh://USERNAME@gerrit.wikimedia.org:29418/mediawiki/extensions/BlueSpiceFoundation.git 

In den Repositories von BlueSpice ist es notwendig, das "+2" oder "Merge"-Recht zu haben, bevor man den Code selbst in das Produkt einpflegen kann. Um dieses zu bekommen, wendet euch an glaser@hallowelt.biz.

Wenn ihr eine eigene BlueSpice-Erweiterung schreiben wollt, lasst euch hier ein eigenes Repository geben. Am besten folgt ihr der Namenskonvention

mediawiki/extensions/BlueSpiceMeinWidget.git

Entwicklungsumgebung aufsetzen

Eine ausführliche beschreibung haben wir auf eine eigene Seite Installationsanleitung gepackt.

See also

• https://www.mediawiki.org/wiki/How_to_become_a_MediaWiki_hacker

Wird im Wiki von einem "Artikel" gesprochen, so ist damit in der Regel der Inhalt einer Einzelseite gemeint. Im Zusammenhang mit im Wiki erstellten Büchern ist ein Artikel oft gleichbedeutend mit einem Buchkapitel.

Instrumententafel oder Armaturenbrett. Hier werden wichtige Informationen auf einer Seite zusammengefasst. Diese Seite dient als Einstiegspunkt für Nutzer zu tiefergehenden Informationen. Das Dashboard ist meist nutzerspezifisch und kann daher individuell angepasst werden.

---

Feedback zur Dokumentation ist im Community-Forum möglich.