FAQ für freiwillige Helfer

In regelmäßigen Abständen findet ein allgemeiner Beta-Test der nächsten Buchversion statt. Dieser Beta-Test wird auf der Homepage http://www.das-asterisk-buch.de bekannt gegeben.

1. Was sollte gemeldet werden?
1.1.

Ich habe etwas aus dem Buch ausprobiert. Es funktioniert aber nicht wie abgedruckt. Soll ich das melden?

Ja, unbedingt! Bitte mit Angabe der URL und einer evt. Fehlermeldung.

1.2.

Wie kann ich einen Fehler melden?

Am einfachsten per E-Mail an den Autor Stefan Wintermeyer

2. Fragen zur Technik
2.1.

In welchem Format wird das Buch geschrieben?

Der Quelltext des Buches wird im DocBook-Format erstellt. Informationen zu DocBook finden Sie auf http://www.docbook.org.

2.2.

Warum gibt es kein Wiki, in dem ich einfach Fehler ändern kann?

Das Buch muss zu einem bestimmten Zeitpunkt gedruckt werden. Dazu benötigt der Setzer einen strukturierten Text. Die Arbeit des Setzers ist mit DocBook am einfachsten. Außerdem zwingt DocBook den Autor eines Texts zu klaren Stukturen.

Wenn der ganze Text in einem Wiki stehen würde, dann würde sich der Export aus diesem Wiki sehr schwierig gestalten. Mediawiki hat einfach keine für eine technische Dokumentation sinnvollen Tags.

Es kann sein, dass wir als Kompromiss in Zukunft Annotate von Dominik Brettnacher einsetzen werden. Aber damit tretten dann wahrscheinlich wieder eine Reihe von Performanceproblemen auf. Der Webserver ist immer recht gut besucht und da haben statische HTML Dateien enorme Vorteile.

2.3.

Mit welchem Editor kann man am besten DocBook schreiben?

Das ist fast schon eine "religiöse" Frage. ;-) Für die einen ist es emacs und für die anderen vi. Der Autor benutzt meistens den XMLmind XML Editor, der sich von http://www.xmlmind.com/xmleditor/ herunterladen lässt.

2.4.

Kann ich auch die Original-DocBook-Dateien bekommen?

Ja, sollten Sie in einem Kapitel sehr viel verändern wollen, so können Sie dafür gerne die Original-Dateien erhalten. Schreiben Sie dazu bitte eine E-Mail an den Autor Stefan Wintermeyer .

2.5.

Was ist mit dem Thema XYZ? Das habe ich noch nicht gefunden und es ist doch so wichtig.

Melden Sie sich per E-Mail an und beschreiben Sie kurz das Thema.

Wenn Sie bereit sind selber ein entsprechendes Kapitel zu schreiben und es unter der FDL zu veröffentlichen, dann lassen Sie sich von Stefan Wintermeyer ein Beispiel DocBook Kapitel schicken.

2.6.

Wie wird die Webseite generiert?

Ein Skript zieht sich mehrmals am Tag automatisch die aktuellen DocBook-Quellen aus unserem SVN und generiert daraus die HTML-Seiten. Diese werden dann per move an die richtige Stelle im Webserver geschoben. Alle Seiten sind statisch, um auch große Lasten problemlos zu verarbeiten.

3. Allgemeine Fragen
3.1.

Mir fehlt bei den Installationsbeschreibungen mein Lieblings-Betriebssystem. Was kann man da machen?

Idealerweise schreiben Sie das entsprechende Kapitel und schicken es an Stefan Wintermeyer . Falls Sie nicht genügend Know-how dazu besitzen, schreiben Sie bitte eine entsprechende Anfrage.

3.2.

Werden Helfer irgendwo aufgelistet?

Jeder, der beim Projekt mitmacht oder nützliches Feedback gibt, wird in Kapitel 22, Danksagungen aufgeführt. Falls dies nicht gewünscht wird, bitte dies beim Einreichen eines Bugs mitteilen.