Redaktionelle Vorgaben für CMS-Kapitel
Dies sind die allgemeingültigen Vorgaben. Bitte haltet euch daran, es spart Zeit und vergebliche Arbeit.
Änderungen am vorhandenen Kapitel
Der aktuelle Stand eures Kapitels wird als PDF bereitgestellt. Bitte verwende die PDF-Kommentarwerkzeuge für Korrekturen, Streichungen, Ergänzungen, Änderungen.
Informationen zu neuen Abbildungen (s. u.) füge bitte als Dateiname auf ähnliche Weise ein. Korrektur der Bildunterschrift nicht vergessen.
Linkliste
Die Links am Ende des Kapitels beziehen sich immer auf die Sprachversion. Achte darauf, jeweils die relevantesten zuerst zu nennen (und beschränke dich auf die wichtigsten URLs, die der Leserschaft den weiteren Weg zur Software und zur Community ebnen).
Matrix
Die Matrix am Ende der Gartefibel muss bei jeder Neuauflage aktuell sein. Die Angaben sollten sich auf eine Release beziehen, die zum Veröffentlichungsdatum offiziell stable ist.
Gelegentlich kommen neue Zielen hinzu. Gehe also auch dann alle Zeilen durch, wenn du denkst, dass sich bei euch nichts geändert hat - und achte auf die farbige Hervorhebungen.
Entferne die Hervorhebung, wenn du eine Eintragung ergänzt oder korrigiert hast.
Abbildungen
Wir wollen Referenzprojekte und die Benutzeroberfläche zeigen. Stelle dich darauf ein, dass layoutbedingt nicht alle Abbildungen an der gewünschten Stelle stehen können. Bei direktem Inhaltsbezug setze bitte einen Hinweis an die Textstelle.
Wir brauchen
- mindestens 3 aussagekräftige und möglichst unterschiedliche Screenshots vom Backend
- 4-6 Screenshots (ohne Browserrahmen) von Beispielprojekten, die mit dem CMS umgesetzt wurden (auf Geheimhaltungsfragen prüfen - bei Intranet-Screenshots Genehmigung beifügen, keine personenbezogenen Daten leaken)
Dateiformate/Größen
- TIFF (CMYK), 15 cm breit bei 300 dpi (ohne eingebettetes Farbprofil) für den Druck
- JPG oder PNG (RGB), mind. 400 bis max. 1200 px breit (idealerweise alle in derselben Breite) für die Website
Dateinamen!
- [CMS]yyyy[Projektname].[erw] - Beispielprojekt
- [CMS]-[Versionsnr]_yyyy_Backend-[Stichwort].[erw]
Dateinamen ohne Leerzeichen, keine weiteren Punkte.
Impressum
Überprüfen und ggf. neue Autorinnen oder Übersetzer hinzufügen.
Abkürzungsverzeichnis + Glossar
Führst du mit den Änderungen neue Abkürzungen oder Fachbegriffe ein, füge diese bitte an entsprechender Stelle hinzu. Denke auch an eventuelle Verweise.
Vereinsliste
Überprüfe bitte auf der entsprechenden Seite, ob die Adresse eures offiziellen Vereins (lokal, international) noch stimmt - oder ob sie ggf. gar noch fehlt.
Neue CMS-Kapitel
Text
Es gibt eine Dateivorlage für neue Kapitel, die bereits die verwendeten Formatvorlagen enthält. Du erhältst sie von der Redaktion, mit der du bereits in Kontakt stehen dürftest. In der Mustervorlage findest du weitere Hinweise.
Abbildungen
Zusätzlich zu obigen Anforderungen liste bitte die Abbildungen mit Bildunterschriften am Ende des Kapiteltextes auf. Bei Fotos gebe bitte zusätzlich den Namen der Fotografin sowie ggf. die CC-Lizenz an.
Inhaltliche Richtlinien
Die „Gartenfibel“ ist eine sachliche Publikation, die Entscheidern dabei helfen soll, das für sie passende CMS auszusuchen. Da dieses Projekt keine finanziellen Mittel für eine unabhängige Redaktion hat, die den kompletten Inhalt von einem neutralen Standpunkt aus schreiben könnte, sind wir darauf angewiesen, dass die Communities diesen Standpunkt einnehmen (also einen Schritt zurücktreten) und „ihr“ System mit aller gebotenen Zurückhaltung vorstellen.
Eine Schlussredaktion findet statt. Richtet euch darauf ein, dass euch Formulierungen wie die folgenden um die Ohren gehauen werden:
- „Ein System, mit dem man Websiten jeglicher Größe erstellen kann“ – Sorry, aus den Kinderschuhen sind alle Systeme entwachsen. Das setzen wir voraus.
- „Leicht und intuitiv zu bedienen“ – Zu subjektiv. Diese Aussage ist nicht allgemeingültig, sondern hängt von der Vorbildung der Benutzer ab. Denkt übrigens jedes CMS von sich.
- „XY ist binnen weniger Jahre zu einem der beliebtesten CMS am Markt geworden“ – zu marktschreierisch, nicht nachprüfbar
- Superlative (beste, tollste, schönste) – vermeiden
- Alle Aussagen in Listenform – bitte umschreiben, wir wollen Fließtext
- Fachbegriff-Bingo – vermeiden (verunsichert die Leserschaft und verschleiert oftmals die eigentliche Aussage)
- Direkte Anrede – vermeiden. „Sie können xy“ wird zu „Redaktionsmitglieder können xy“ oder „Adminstratorinnen werden xy zu schätzen wissen“
Gendering
Wir wollen mehr Diversität erreichen. Es ist belegt, dass das “generische Maskulinum” eine Hürde ist. Wir haben uns im CMS Garden dafür entschieden:
- Das “Runterbrechen auf einen Stellvertreter” vermeiden, wo es dem Stil nicht schadet. Wir schreiben “die Redaktion” statt “der Redakteur” - oder “wer sich im Backend einloggt, findet …” statt “der Backend-User findet …”
- Wo wir es nicht vermeiden können, wechseln wir die Geschlechter ab, wobei wir Berufsstereotype aufbrechen. “Der Designer” und “die Administratorin” zum Beispiel.
Tipps für einen guten Stil
Zielgruppen verstehen. Die Gartenfibel richtet sich an Menschen, die mit dem Internet umgehen können, aber eher keine IT-Fachleute sind. Wir bemühen uns um einen Grad an Verständlichkeit, dem unsere Eltern folgen können. Einzig der Abschnitt über „Technologie“ darf sich an Fachleute richten, denn dieser wird vermutlich zur Entscheidungshilfe der IT-Abteilung vorgelegt.
Fachbegriffe erläutern. Wir haben ein Glossar und arbeiten nebenher darauf hin, die CMS-spezifischen Grundbegriffe (z. B. Module / Extensions / Plugins) in einem weiteren Teil des Anhangs zu erläutern. Bitte sammeln. Nichtsdestotrotz sollten spezielle Fachbegriffe direkt im Text aufgelöst werden.
Suche nach Alleinstellungsmerkmalen. Was hebt das System von anderen ab? ScientificCMS zum Beispiel ist durch das Feedback der wissenschaftlichen Nutzerinnen auf den wissenschaftlichen Einsatz optimiert worden.
Schwächen nennen. Offenheit schafft Vertrauen und nimmt Menschen für dich ein. Was du verschweigst, fällt dir später auf die Füße. Und es gibt immer genug Entscheider, die die genannten Schwächen in Kauf nehmen können, wenn sie sie nur kennen.
Drei der vorliegenden Kapitel lesen. Mindestens. Dadurch kommst du leichter in den Schreibstil, den wir haben wollen.
Mit Sorgfalt übersetzen Übersetzungen sollen nicht wortgetreu, sondern in ihrer Sprache sinnvoll sein. Lasst bitte eure Texte - egal in welcher Sprache - von muttersprachlichen Communitymitgliedern gegenlesen.
Ansprechpartnerin
Schlussredaktion: @meike.jung