PHP praxisorientiert lernen: Einleitung für Autoren

Aus Wikibooks


Bitte beachte dass dieses Buch noch viele grundlegende Artikel und Struktur braucht, deswegen bitten wir euch jetzt noch nicht mit zu Helfen, aber trotzdem Danke für euer Interesse!

WikiBooks ist dazu gedacht, dass jeder sein Wissen in die Bücher einbringt. Dieses Motto gilt natürlich auch für dieses Buch, wir bitten Mitautoren jedoch auf ein paar Dinge zu achten damit dieses Buch nicht einfach nur so eine Auflistung der Features von PHP ist, sondern immer noch ein in sich geschlossenes, mit bestimmten Richtlinien versehenes Werk. Aber trotzdem, Danke, dass du mithelfen willst!

Diese Art von Beiträgen ist gesucht/gewünscht[Bearbeiten]

Es gibt viele Themen die dieses Buch ansprechen sollte, für die wir jedoch bisher noch niemanden gefunden haben der das nötige Wissen besitzt - falls du noch etwas zu einem Themengebiet weißt welches bisher noch nicht behandelt wurde dann zögere nicht und erstelle ein neues Kapitel mit dem gewünschten Namen. Um das neue Kapitel dann auch in das Buch zu integrieren musst du nur noch das Inhaltsverzeichnis auf der Startseite, die Navigationslinks im vorherigen und nachfolgendem Kapitel ändern damit diese dein Kapitel mit einschließen.

Wenn etwas falsch ist[Bearbeiten]

Niemand weiß alles und manchmal kann es schon vorkommen das ein Autor des Artikels etwas falsch verstanden hat und dies nun in den Artikel einfließen lässt. Falls du einen solchen Fall findest informiere dich bitte zuerst ob deine Vermutung über den fehlerhaften Inhalt wirklich stimmt, als Faustregel für den Gegenbeweis gilt: Je offizieller die Seite ist von der du die Informationen über den Fehler holst desto besser.

Ändere dann die entsprechende Stelle auf der Seite und mache auf der Diskussionsseite des jeweiligen Kapitels einen entsprechenden Vermerk woher deine Richtigstellung stammt damit sie von anderen Benutzern ggf. überprüft werden kann.

Rechtschreibfehler macht jeder, sei es nun mangels Bildung oder Zeit, falls du also einen findest scheue dich nicht ihn zu korrigieren und gebe in der Zusammenfassung an: "Rechtschreibung überarbeitet" und kreuze "Nur Kleinigkeiten verändert" an. Danke für deine Mitarbeit!

Lehrbuch, kein Kompendium![Bearbeiten]

Da in diesem Buch der Inhalt oft bewusst ausgewählt wurde, sollten Änderungen insgesamt nur äußerst vorsichtig - bei den ersten Kapiteln am Besten nur nach Absprache auf der Diskussionsseite - gemacht werden. Überlegen Sie sich immer genau, ob Inhalte eventuell für den Leser zu diesem Zeitpunkt zu komplex sind.

Schauen Sie sich vorherige Kapitel an, konstruieren Sie Wissensprofil des Lesers zu dem Zeitpunkt, bei dem er eigentlich das Kapitel lesen sollte. PHP-Doc Kommentare sind zum Beispiel durchaus sinnvoll, aber einen Leser der nicht weiß was Variablen sind mit OOP Kommentaren zu behelligen ist unsinnig - in dem Bereich OOP jedoch sinnvoll.

Wie Sie Texte hier schreiben sollten[Bearbeiten]

Wenn Sie Fragen zum Arbeiten als Autor mit einem Wiki im Allgemeinem, oder WikiBooks im Speziellen haben, dann sollten Sie sich am Besten das WikiBooks Lehrbuch anschauen oder bei Fragen zur Textgestaltung  das entsprechende Kapitel bei Wikipedia durchlesen.

Sie sollten am Besten immer neue Begriffe kursiv schreiben, von jedem Absatz hingegen immer die Teile fett schreiben, welche den Inhalt kurz und knapp wiedergeben, so dass man selbst nur beim Überfliegen die wichtigsten Dinge noch mitbekommt.

Ein neues Kapitel schreiben[Bearbeiten]

Wenn Sie neue Kapitel schreiben wollen, erstellen Sie einen Link im Inhaltsverzeichnis in der richtigen Sektion (beachten Sie die Regeln zum Erweitern des Anfänger-Teiles) und klicken Sie auf den roten Link. Das Format von Kapitelnamen lautet immer PHP praxisorientiert lernen: Kapitelname: Unterkapitel, beachten Sie das Leerzeichen zwischen Doppelpunkt und Namen.

Ein Ober- mit mehreren Unterkapiteln bietet sich an, wenn Sie mehrere Kapitel zu einem Thema haben. Wenn Sie nur ein Kapitel haben - was auch nicht schlecht ist -, dann lassen Sie den letzten Doppelpunkt und den Namen des Unterkapitels einfach weg: PHP praxisorientiert lernen: Kapitelname.

Sie können, falls Sie das wünschen, auch noch ein "In Arbeit"-Schild aufstellen um andere Autoren darauf aufmerksam zu machen das Sie im Moment den Artikel schreiben.

Zu guter letzt sollten Sie auch noch die Navigation einbinden (Beispiele zur Nutzung finden Sie in jedem Kapitel), und bei dem nächsten und vorherigen Kapitel die Navigation anpassen.

Texte bearbeiten[Bearbeiten]

Wenn Sie Texte bearbeiten wollen, ist Ihre Mitarbeit immer willkommen - bei Artikeln mit dem Fachwissen gesucht-Vermerk sogar ausdrücklich gewünscht!

Sie sollten einen Artikel bearbeiten (Ihr Wissen einmal vorausgesetzt) wenn Ihnen auffällt, dass das Kapitel sehr kurz ist, Teilgebiete vergessen wurden, unklar formuliert wurde oder wenn Sie glauben, dass etwas thematisch nicht passt. Im letzten Fall sollten Sie den entsprechenden Teil löschen und gleichzeitig auf der Diskussionsseite einen entsprechenden Vermerk machen, mit ihrer Begründung.

Eigene Vorlagen dieses Buches[Bearbeiten]