1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<title>Einen Fehler melden</title>
</head>
<body>
<h2>Einen Fehler melden</h2>
<p>Erfolgreiche Softwareentwicklung ist nahezu unmöglich ohne zu testen, und das gilt natürlich auch für Scribus. Testen bedeutet, die Software zu benutzen, insbesondere die Entwicklerversionen. Entdeckte Bugs (Fehler) müssen gemeldet werden, damit die Entwickler erfahren, daß etwas falsch ist oder zumindest falsch zu sein scheint, damit das Problem behoben werden kann. Manchmal ist die Lösung einfach, die Dokumentation zu verbessern. Öfter müssen die Entwickler aber wissen, welche Funktionen die Benutzer brauchen. In dem Fall sollte jemand, der eine bestimmte Funktion vermisst oder eine großartige Idee hat, dies dem Scribus Team mitteilen.</p>
<p>Die Prozedur ist in allen Fällen gleich. Es gibt eine Softwarekategorie namens <i>bug tracking systems (Fehlerverfolgungssysteme)</i>, die es Entwicklern erlaubt, Fehlerberichte und RFEs (requests for enhancement / Verbesserungsanfragen) zu verfolgen, zu diskutieren und nachzuprüfen. Das Scribus Team hat sich entschieden, als Bug Tracking System <a href="http://www.mantisbt.org/">Mantis</a> zu verwenden. Wenn Sie helfen wollen, Scribus zu verbessern oder wenn Sie unbedingt eine Funktion brauchen, sollten Sie lernen, Mantis zu nutzen.</p>
<h2>Account erstellen</h2>
<p>Gehen Sie zuerst zur <a href="http://bugs.scribus.net/signup_page.php">Registrierung</a>. Sie kommen zu einer Seite, die so aussieht:</p>
<br>
<table width="100%"><tr><td align="center"><img src="images/Mantis_signup.png"/></td></tr></table>
<br>
<p>Geben Sie einen Benutzernamen, Ihre Email-Adresse und die angezeigten Ziffern ein. Klicken Sie »Signup« und warten Sie bis Ihr Account bestätigt wurde und Sie eine Email mit einem Passwort bekommen. Sie können Ihre persönlichen Einstellungen unter »My account« jederzeit ändern, wenn Sie eingeloggt sind. Unter anderem die Sprache auf »Deutsch« stellen. Nehmen Sie sich bitte die Zeit, die verschiedenen Möglichkeiten anzuschauen, ob sie für Sie nützlich sind.</p>
<h2>Bevor man eine Fehlermeldung einreicht</h2>
<p>Wenn etwas nicht so funktioniert wie erwartet, oder Sie die Idee des Jahrhunderts haben, fangen Sie bitte nicht an, massenhaft Fehlermeldungen zu schreiben. Es ist durchaus möglich, daß jemand anderes schon das gleiche Problem hatte, vielleicht sogar die gleiche großartige Idee. Wir empfehlen fünf Schritte, damit Ihr Bericht nicht als »Duplikat« oder mit »Keine Änderung nötig« geschlossen wird.</p>
<ol>
<li>Lesen Sie die <a href="http://docs.scribus.net/">Scribus Online Dokumentation</a>, durchstöbern Sie das <a href="http://wiki.scribus.net/canvas/Hauptseite">Scribus Wiki</a>, oder erwägen Sie den Kauf des Offiziellen Scribus Handbuchs. Es gibt jede Menge Informationen in verschiedenen Sprachen, und vielleicht hat schon jemand seine eigenen Erfahrungen in einem Wiki-Artikel geschrieben, oder das Dokumentationsteam hat eine Funktion / ein Problem schon gründlich dokumentiert.</li>
<li>Versuchen Sie, Scribus wirklich zu nutzen und lernen Sie seine Konzepte kennen. Die Benutzung von Scribus ist nicht schwer zu lernen, aber sie ist <a href="about2.html">völlig anders</a> als z.B. bei einem Textverarbeitungsprogramm.</li>
<li>Beschreiben Sie Ihr Problem oder Ihre Idee auf einer der <a href="mailing_lists.html">Mailinglisten</a>. Normalerweise klären sich Dinge schnell auf. Oft genug ist ein vermeintlicher Fehler nur mangelnde Erfahrung.</li>
<li>Fragen Sie im <a href="irc.html">IRC</a>. Dies bietet sich besonders dann an, wenn Sie wirklich schnelle Hilfe brauchen.</li>
<li>Falls Ihre Fragen immer noch nicht beantwortet sind, können Sie die Fehlerberichte durchsuchen. Sie können nach Schlüsselwörtern suchen. Wie Sie bei dem Bildschirmfoto unten sehen, können Sie ein Schlüsselwort in das Feld »Search / Suche« eingeben. Dann klicken Sie auf »Apply Filter / Filter« und Mantis sucht alle Meldungen heraus, die diesen Text enthalten. Wenn Sie das englische Wort nicht kennen, nach dem Sie suchen sollten, können Sie das mehrsprachige <a href="http://wiki.scribus.net/index.php/Glossary_of_technical_terms_used_in_Scribus_and_its_translations">Glossar</a> im Wiki durchsuchen, um eine Übersetzung zu finden. Wenn Sie die englischen Namen der Menüpunkte erfahren wollen, wechseln Sie einfach in den <a href="settings1.html#1">Allgemeinen Einstellungen</a> zur englischen Oberfläche.</li>
</ol>
<br>
<table width="100%"><tr><td align="center"><img src="images/Mantis_searching.png"/></td></tr></table>
<br>
</p><p>Sie werden feststellen, daß Mantis verschiedene Farben verwendet, um den Status der Einträge anzuzeigen. Die Bedeutung der verschiedenen Farben sehen Sie hier:</p>
<table class="width100" cellspacing="1"><tr><td class="small-caption" width="14%" bgcolor="#fcbdbd">neu</td><td class="small-caption" width="14%" bgcolor="#e3b7eb">Rückmeldung</td><td class="small-caption" width="14%" bgcolor="#ffcd85">anerkannt</td><td class="small-caption" width="14%" bgcolor="#fff494">bestätigt</td><td class="small-caption" width="14%" bgcolor="#c2dfff">zugewiesen</td><td class="small-caption" width="14%" bgcolor="#d2f5b0">erledigt</td><td class="small-caption" width="14%" bgcolor="#c9ccc4">geschlossen</td></tr></table>
<br>
<ul><li><i>New / Neu</i>: Der Fehler / Verbesserungswunsch ist gemeldet, es gibt noch keine Entscheidung, wie weiter vorgegangen wird.</li>
<li><i>Feedback / Rückmeldung</i>: Es wird entweder vom ursprünglichen Reporter oder von jemand, der kommentiert hat, eine Rückmeldung erwartet. Dies passiert oft, wenn ein Fehler nicht reproduziert werden kann.</li>
<li><i>Acknowledged / Anerkannt</i>: Wenn das Team entschieden hat, daß ein Vorschlag es wert ist, für die weitere Entwicklung berücksichtigt zu werden, wird der Status auf »anerkannt« gesetzt. Dies passiert meistens bei Verbesserungsvorschlägen.</li>
<li><i>Confirmed / Bestätigt</i>: Wenn ein gemeldeter Fehler durch andere reproduziert werden kann, wird der Status auf »bestätigt« geändert. Das ist, was normalerweise bei Fehlermeldungen geschieht.</li>
<li><i>Assigned / Zugewiesen</i>: Ein Fehler oder ein Verbesserungsvorschlag wurde einem Entwickler zugewiesen, um ihn zu beheben oder um eine neue Funktion hinzuzufügen.</li>
<li><i>Resolved / Erledigt</i>: Der Fehler oder Verbesserungsvorschlag wurde gelöst. Das bedeutet nicht unbedingt, daß ein Entwickler auch nur eine Zeile Code geschrieben hat. Wenn etwas nicht gelöst werden kann oder muß, wird es auch auf »erledigt« gesetzt.</li>
<li><i>Closed / Geschlossen</i>: Das Ende der Lebenszeit einer Meldung. Wenn alles funktioniert, wird der Fall endgültig geschlossen, und die schaurige Anzahl der Meldungen und Wünsche ist ein bißchen kleiner.</li>
</ul>
<br>
<h2>Einreichen einer Fehlermeldung</h2>
<br>Um eine Fehlermeldung einzureichen, müssen Sie auf »Report Issue / Eintrag erfassen« gehen. Sie werden eine Menge Felder zum Ausfüllen vorfinden:
<br>
<table width="100%"><tr><td align="center"><img src="images/Mantis_new_report1.png"/></td></tr></table>
<br>
<ul><li><i>Category / Kategorie</i>: Wählen Sie die Kategorie, die Ihrer Meinung nach am besten paßt. Wenn keine paßt, nehmen Sie »General«.</li>
<li><i>Reproducibility / Reproduzierbar</i>: Wenn Sie einen Fehler melden, können Sie ihn reproduzieren? Wie oft kommt er vor? Wählen Sie die passende Häufigkeit. Verbesserungsvorschläge haben hier stets »immer«, da die Funktion immer fehlt bis das Problem gelöst ist.</li>
<li><i>Select Profile / Profil wählen</i>: In Ihren persönlichen Einstellungen können Sie Benutzerprofile für Ihre Meldungen erstellen. Das ist vor allem nützlich, wenn Sie mehr als ein Betriebssystem oder mehr als eine Distribution nutzen. Sie können für jedes Betriebssystem ein Profil erstellen, und wenn ein Problem bei einem bestimmten System auftritt, einfach das Profil auswählen anstatt jedesmal die Daten (Rechnertyp, Betriebssystem, BS-Version) einzugeben.</li>
<li><i>Platform / Rechnertyp</i>: Geben Sie hier den Typ Ihres Prozessors ein (z.B. x86, x86-64, PPC, SPARC).</li>
<li><i>OS / Betriebssystem</i>: Ihr Betriebssystem (.z.B. Linux, Windows, Mac OS X, OS/2, eCS).</li>
<li><i>OS-Version / BS-Version</i>: z.B. Debian 8.3, OpenSUSE 42.1, Windows 10, OS X 10.11.3, eCS 2.1</li>
<li><i>Product Version / Produktversion</i>: Scribus gibt es in verschiedenen Entwicklungssadien, dem stabilen (1.4.x) und dem Entwicklerzweig (1.5.x) mit einigen mehr oder weniger stabilen Versionen. Versichern Sie sich, daß Sie die richtige im Dropdown-Menü auswählen.</li>
</ul>
<p>Wenn Sie mit den Formalitäten fertig sind, können Sie endlich anfangen, Ihren Bericht zu schreiben:</p>
<br>
<table width="100%"><tr><td align="center"><img src="images/Mantis_new_report2.png"/></td></tr></table>
<br>
<ul><li><i>Summary / Zusammenfassung</i>: Eine kurze Beschreibung Ihrer Meldung. Sie wird die »Überschrift« im Bugtracker.</li>
<li><i>Description / Beschreibung</i>: Beschreiben Sie das Problem so genau, aber auch so knapp wie möglich. <b>Bitte schreiben Sie hier keine Romane!</b> Es kann auch hilfreich sein, Bildschirmfotos hochzuladen (siehe unten). Falls Ihr Anliegen ein Verbesserungswunsch ist, geben Sie bitte ein Anwendungsbeispiel. Das Team braucht Beispiele, um zu verstehen, was hinter der Idee steckt und wie die neue Funktion Anwendern helfen kann, effektiver zu arbeiten. In anderen Worten, beschreiben Sie nicht nur das <i>Was</i> und das <i>Wie</i>, sondern auch das <i>Warum</i>.</li>
<li><i>Steps To Reproduce / Schritte zur Reproduktion</i>: Wenn Sie einen Fehler reproduzieren können, beschreiben Sie bitte die nötigen Schritte, um ihn auf anderen Computern nachzuvollziehen.</li>
<li><i>Additional Information / Zusätzliche Informationen</i>: Hier können Sie zusätzliche Informationen, z.B. von Mailinglisten oder Meldungen eines Debuggers, ergänzen, von denen Sie denken, daß sie in diesem Zusammenhang nützlich sind.</li>
</ul>
<p>Jetzt haben Sie es fast geschafft, aber vielleicht möchten Sie noch eine Datei hochladen, z.B. ein Bildschirmfoto oder eine Scribus-Datei. Dazu klicken Sie auf »Search / Durchsuchen« und wählen die Datei aus.</p>
<br>
<table width="100%"><tr><td align="center"><img src="images/Mantis_new_report3.png"/></td></tr></table>
<br>
<p>Falls Sie nicht möchten, daß außer den Entwicklern noch andere Ihre Meldung sehen, können Sie die Sichtbarkeit auf »Private / privat« setzen. Das kann z.B. nötig sein, wenn Ihre Datei durch ein Copyright geschützt ist. </p><p>Wenn alles zu Ihrer Zufriedenheit ist, klicken Sie »Submit Report / Bericht absenden«, und das war es schon.</p>
<h2>Personalisierte Ansicht</h2>
<p>Wenn Sie eingeloggt sind, können Sie sich eine übersichtlichere Ansicht des Bugtrackers anzeigen lassen. Klicken Sie auf »My view / Übersicht«, und Mantis zeigt Ihnen eine strukturierte Ansicht der kürzlich geänderten Einträge:
<br>
<table width="100%"><tr><td align="center"><img src="images/Mantis_my_view.png"/></td></tr></table>
<br>
<ul><li><i>Linke Spalte</i>: Nicht zugewiesene, erledigte, von Ihnen beobachtete Einträge.</li>
<li><i>Rechte Spalte</i>: Von Ihnen berichtete, vor kurzem bearbeitete Einträge.</li>
</ul>
</body>
</html>
|
