Was ist ein guter Weg, um Unterstützung von der PmWiki-Gemeinschaft zu bitten, mit der geringstmöglichen Verschwendung von deren Zeit und Mühe, und mit den schnellsten positiven Ergebnissen durch die Antwortenden?
Wenn Sie ein Problem mit PmWiki, Kochbüchern oder der Umgebung, in der PmWiki installiert ist, haben, lohnt es sich, einige der oder alle der folgenden Vorbereitungen und Vorkehrungen zu unternehmen.
Erreichbare Informationen wiederholt lesen
- Stellen Sie so gut es geht sicher, dass Sie die aktuelle Version aller Rezepte und aller Softwareteile von PmWiki installiert haben,
- lesen Sie in der aktuellen (ggf. der englischen) Dokumentation nach, was dort über Updates und Neuerungen steht,
- durchsuchen Sie das (englische) PmWiki-Problem-Verfolgungs-System danach, ob das Problem schon beschrieben wurde,
- durchsuchen Sie die Mailingliste (englisch),
- durchsuchen Sie PmWiki,
- inspizieren Sie ihre aktuelle Umgebung (siehe PHPInfo),
- prüfen Sie die Problemlösungs-Anleitung,
- es gibt Hilfen zu spezifischen Fehlermeldungen,
- siehe die FAQs und die FAQ-Kandidaten-Seite
Falls die Anfrage einen oder alle dieser Punkte betrifft
dann wird eine geeignete und akkurate Information einen langen Weg bis zum Isolieren einer Ursache und der Bestimmung der Lösung gehen.
Reproduzieren Sie das Problem
Der nächste Schritt ist, das Problem in einer anderen Umgebung zu reproduzieren, wenn das machbar ist.
- Die PmWiki-Test-Seiten? sind ein guter Platz, das zu tun,
- erwägen Sie, alle Rezept in Ihrer config.php auszukommentieren, danach eines nach dem anderen wieder zu aktivieren, bis das Problem wieder auftritt,
- ein anderer brauchbarer Weg ist, eine Gruppe anzulegen und gruppenspezifische Anpassungen vorzunehmen, um das Problem einzukreisen.
Assistenz beim Suchen
Wenn Sie das Alles gemacht haben und sind mit Ihrem Problem nicht schlauer geworden (wenn auch vielleicht schlauer was PmWiki angeht) können Sie
Wenn Sie um Hilfe bitten, fühlen Sie sich frei
- einen Link auf das infrage kommende Wiki, insbesondere das Problem, anzubieten,
- ein Beispiel für das Problem in Ihrem Wiki oder in einer Testseite? parat zu haben,
- Schreibzugriffe auf das Wiki (oder wenigstens die betreffende Seite) zu ermöglichen,
- Das
$EnableDiag-Flag für diese Seite zu setzen, um den Helfern zu ermöglichen, die Umgebung zu untersuchen,
- wenn es um die Performance geht, die Stoppuhr zu benutzen,
- wo es möglich ist, die Versionsnummer des Betriebssystems, des Webservers und von PHP anzugeben,
- wo es möglich ist, die PmWiki-Version und die Version der Rezepte anzugeben,
- ein oder mehrere Testszenarien anzugeben,
- einen Link auf die Dokumentation zu setzen, die Sie für sachdienlich erachten und die Sie bei Ihrer Suche benutzt haben ( das wird außerdem ein Update der Dokumentation fördern).
Alle diese Dinge würden diejenigen unterstützen die Ihnen helfen wollen, und ihnen einen Anreiz schaffen, den Kern des Problems herauszubekommen, ohne dass sie weitere eingrenzende Fragen stellen müssten.
PmWiki Issue Tracking System PITS|PITS? (Problemverfolgungsystem)
Wenn das Problem sich herausstellt als Programmfehler, Performanceproblem, Änderungswunsch, Erweiterung oder Wunsch nach einem Feature, ist das PITS der richtige Ort für eine Registrierung.
Nochmal, alle die einschlägigen Informationen oben sollten in die Problembeschreibung einfließen, um das Finden einer Lösung zu unterstützen.
Categories: Debugging System tools