Redaktionsrichtlinien

Allgemeine Empfehlungen für das CMS-Garden-Redaktionsteam

Inhaltliche Richtlinien

Unser offizieller Inhalt (also praktisch alles außer Blogposts) und die CMS-Gartenfibel sind sachliche Publikationen. Der Inhalt soll Entscheider*innen dabei helfen, 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. Das schließt auch den ehrlichen Umgang mit Schwächen ein.

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 Benutzenden ab. Denkt übrigens jedes CMS von sich.
  • „$CMS ist binnen weniger Jahre zu einem der beliebtesten CMS am Markt geworden“ – zu marktschreierisch, nicht nachprüfbar
  • Superlative ("beste, tollste, schönste ...") – vermeiden
  • Alle Sätze in Listen- bzw. Stichpunktform – 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 „Adminstrator*innen werden xy zu schätzen wissen“

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. Ohne dabei aber herablassend zu klingen, also immer respektvoll.

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 in der Gartenfibel 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 Nutzer*innen 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*innen, 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.

Zweisprachigkeit

Wir wollen möglichst alle Inhalte auf englisch erstellen und auf deutsch übersetzen (oder umgekehrt). Die Übersetzung ist verpflichtend für die Veröffentlichung der CMS-Gartenfibel.

Gendern

Wir wollen in unserer Branche noch mehr Diversität erreichen. Es ist belegt, dass das “generische Maskulinum” eine Hürde ist. Wir haben uns im CMS Garden daher für folgendes 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.
  • Habt bitte auch die nonbinären Identitäten im Blick, die sich weder mit "er" noch mit "sie" identifizieren können.
  • Wenn nicht elegant vermeidbar, ist "die Entwickler*innen" inklusiver als "die Entwicklerinnen und Entwickler".

Impressum und Lizenz

Durch deinen Beitrag erklärst du dich damit einverstanden, dass die Texte unter einer Creative-Commons-Lizenz veröffentlicht werden (CC BY-SA = Attribution der Namen, verwendbar unter gleichen Bedingungen).

Deshalb überprüfe bitte auch die angegebenen Namen, wer den Inhalt verfasst bzw. übersetzt hat. Füge neue hinzu und entferne ggf. diejenigen, deren Urheberstatus für die aktuelle Version keine Rolle mehr spielt.

Alle Namen werden regelmäßig im Impressum der Printausgabe der CMS-Gartenfibel aktualisiert.

Illustrationen

Illustrationen motivieren Lesende, Zeit in den Inhalt zu investieren.

Bei den CMS-Portraits wollen wir namhafte Projekte und die Bedienoberfläche (GUI) zeigen. Aus Printlayoutgründen kann es vorkommen, dass nicht alle bereitgestellten Screenshots Platz finden und nicht unbedingt an der vorgesehenen Stelle im Textfluss.

Benötigt für CMS-Portraits

  • 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 und Copyright prüfen - bei Intranet-Screenshots Genehmigung beifügen, keine personenbezogenen Daten leaken)

Dateiformate/Größen

  • Jegliches Web-Bildformat, das im Upload erlaubt ist. Breite mindestens 1280 Pixel
  • Seitenverhältnis idealerweise 16/9 - und bitte ein Verhältnis von 16/36 nicht überschreiten.

Dateinamen

Die hochgeladenen Bilder werden für die Printproduktion heruntergeladen, wobei der Dateiname dann durchaus relevant wird. Bitte erspart uns Zeit mit hilfreichen Dateinamen:

  • [CMS]_yyyy_[Projekt-Kurzname].[ext] - Beispielprojekt
  • [CMS]-[Versionsnummer]_yyyy_Backend-[Stichwort].[ext] - Backend-Screenshots

Dateinamen ohne Leerzeichen. Keine weiteren Punkte bitte.

Alternativtexte und Beschriftungen

Wir wollen diese Website so zugänglich wie möglich für alle gestalten.

Beim Upload eines Bildes ist der Alternativtext ein Pflichtfeld. Bitte erstelle eine sprechende Beschreibung für jegliche Illustration oder Fotografie. Ausnahme: Logos dürfen "XY Logo" als Alternativtext haben.

Stell dir vor, das hier wäre eine Radiosendung und die Moderation würde ständig "noch so ein Bild" sagen. Nicht nett. Umgehe das Pflichtfeld also nicht mit "Illustration: Screenshot" oder "Foto von der Veranstaltung".

Beschriftungen sollten den Alternativtext nicht wiederholen - und umgekehrt. Wenn die Beschriftung allerdings den Bildinhalt wiedergibt, darf ausnahmsweise in den Alternativtext "Foto, siehe Beschriftung". Solche Bilder allerdings dann bitte nicht als Header-Bilder verwenden, zu denen wird nämlich keine Beschriftung ausgespielt.

Kopiere keinesfalls den Dateinamen in das Alternativtext-Feld! (Im Gegenteil, bitte überprüfe den Titel des Bilds, damit in der Medienübersicht möglichst auch sprechende Titel statt der Dateinamen stehen.)

Lizenzen

Bitte beachte auch hier, dass wir auf die Urheberrechte achten. Wir bevorzugen Bilder unter einer Creative-Commons-Lizenz (oder vergleichbar). Es gibt ein Widget, mit dem die Einpflege der Angaben recht einfach ist. Solltest du die erforderlichen Angaben nicht herausfinden können, steht das Feld standardmäßig auf "Alle Rechte vorbehalten", wobei Angaben zur Rechteinhaberin und Quelle möglich (und sinnvoll) sind.

Verwandte Informationen

Bei der Aktualisierung eines CMS-Portraits prüfe bitte auch sorgfältig, ob folgende Inhalte ebenfalls ein Update brauchen:

  • Die Links beziehen sich immer auf die jeweilige Sprachversion des Portraits. Stelle sicher, dass die relevantesten Einstiegspunkte zuoberst genannt sind. Und beschränke dich auf die relevantesten: Das sind in unserem Kontext diejenigen Links, die den Lesenden den Weg ebnen zur Software und zu den Community-Einstiegspunkten.
  • Vereine und Verbände: Prüfe bitte, ob der Eintrag der offiziellen (lokalen und internationalen) Vereine/Verbände/Stiftungen aktuell ist (Adresse). Oder wenn einer fehlt, erstelle bitte ein entsprechendes Profil. Wir veröffentlichen die Profile aller gemeinnützigen CMS-Organisationen, unabhängig davon, ob diese Mitglied im CMS Garden sind.
  • Abkürzungsverzeichnis und 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. Wenn du dich unsicher fühlst bei der korrekten Erläuterung, füge den Eintrag trotzdem ein. Das Redaktionsteam bemüht sich dann um Verbesserungen.

CMS-Matrix

Eine Besonderheit der gedruckten CMS-Gartenfibel ist die Vergleichsmatrix. Wir suchen Mitstreitende, die dabei helfen, diese qualitativ zu verbessern und diese überarbeiteten Informationen auch auf die Website zu bringen. 

Wer daran interessiert ist oder Teil auch lediglich ein Update für die nächste Druckauflage zuarbeiten will, meldet sich am besten über das Kontaktformular. Der dann aktuelle Stand wird als kollaboratives Tabellendokument in der Cloud bereitgestellt; die Zugangsdaten erhalten die Beteiligten persönlich.