Das Handbuch zum freeCodeCamp Medium Publication Editor

Hinweis: freeCodeCamp ist auf Medium nicht mehr aktiv. Jetzt verwenden wir unser eigenes selbst gehostetes Open Source Ghost-Blogging-Tool. Sie lesen dies wahrscheinlich gerade in den freeCodeCamp News? Dies kann jedoch weiterhin nützlich sein, wenn Sie auf Medium veröffentlichen möchten.

Die Open-Source-Community von freeCodeCamp hat einst die größte technische Publikation von Medium veröffentlicht. Jede Woche haben wir mehr als ein Dutzend Geschichten zu Entwicklung, Design und Datenwissenschaft veröffentlicht.

Am längsten war ich der alleinige Herausgeber der Publikation. Ich habe mehr als 1.200 Einreichungen bearbeitet und veröffentlicht. Aber wir haben immer viel mehr hochwertige Beiträge erhalten, als ich veröffentlichen konnte. Also gab ich mir endlich zu, dass ich Hilfe brauchte.

Obwohl freeCodeCamp jeden Monat über Medium, YouTube und unsere Codierungsplattform Millionen von Menschen erreicht, sind wir eine kleine, von Spendern unterstützte gemeinnützige Organisation. Uns fehlen die Ressourcen, um professionelle Redakteure einzustellen.

Ein Mangel an Ressourcen hat uns jedoch in anderen Bereichen nicht aufgehalten. Wir haben Tausende von Freiwilligen, die lokale Lerngruppen leiten, zu Open Source-Projekten beitragen und Foren und Chatrooms moderieren.

Anfang Juli veröffentlichte ich einen Aufruf für freiwillige Redakteure. Mehr als 50 Personen haben geantwortet. Aus diesen Befragten habe ich ein kleines Team von Redakteuren zusammengestellt und geschult.

Gleichzeitig entwarf ich, was letztendlich dieses Editor-Handbuch werden würde. Dies ist unser Leitfaden, wie unser freiwilliges Redaktionsteam Geschichten bearbeitet. Und im Geiste der Transparenz mache ich dies öffentlich.

Dies kann hilfreich sein, wenn Sie ein Fachjournal oder eine mittlere Veröffentlichung bearbeiten. Oder - wenn Sie einer der über 500 Autoren sind, die in der freeCodeCamp-Veröffentlichung veröffentlicht wurden - sind Sie vielleicht nur neugierig, was sich hinter den Kulissen abspielt.

In jedem Fall hoffe ich, dass Sie dieses lebende Dokument interessant und hilfreich finden.

Wie wir Geschichten bewerten, bearbeiten und veröffentlichen

Wir erhalten jede Woche Dutzende von Einsendungen und schützen die Zeit unserer Leser. Wir möchten nur Geschichten veröffentlichen, die:

  • gut geschrieben
  • relevant für unser Publikum aus Entwicklern , Designern und Datenwissenschaftlern
  • sachlich und nicht primär geschrieben, um ein Produkt oder Unternehmen zu übertreiben

Die Realität der Veröffentlichung von Artikeln im 21. Jahrhundert

Die Leute sind beschäftigt. Sie waren noch nie so beschäftigt. Und es wird schlimmer, bevor es besser wird.

Wir müssen für die knappe Zeit unserer Leser optimieren.

Im traditionellen Nachrichtenjournalismus bedeutet dies, die umgekehrte Pyramide zu verwenden - die wichtigsten Fakten an erster Stelle zu setzen und zusätzliche Fakten in absteigender Reihenfolge ihrer Wichtigkeit hinzuzufügen. Auf diese Weise wird jemand, der aufhört zu lesen, immer noch mit der Hauptidee und so vielen wichtigen Fakten wie möglich davonkommen.

Die meisten mittleren Geschichten ähneln eher Feature-Geschichten. Sie erzählen von Ereignissen (Projekt-Postmortems, Berichte über das Erhalten eines Jobs) oder argumentieren einen Punkt (Aufdecken von Sicherheitslücken, Befürworten der Verwendung einer bestimmten Bibliothek für einen bestimmten Zweck).

Eine weitere Kategorie sind Tutorials. Dies kann alles sein, von der Reparatur eines abgetrennten Kopfes in Git bis zum Aufbau einer serverlosen Alexa-Fertigkeit.

Unabhängig von der Art der Geschichte - Nachrichten, Feature, Tutorial - sollten alle nach denselben Tugenden streben:

  • Substanz .Die Geschichte sollte etwas Sinnvolles auf den Tisch bringen. Die Geschichte eines Schriftstellers über den Commodore 64, den ihre Eltern in den 1980er Jahren für sie gekauft haben, mag für sie persönlich von großem Interesse sein, aber wird sie für einen typischen Leser relevant sein? Werden sie mit etwas Nützlichem weggehen? Auf der anderen Seite würden so ziemlich alle unsere Leser davon profitieren, mehr über den Prozess des Vorstellungsgesprächs zu erfahren oder ein besseres Verständnis für die Funktionsweise von CSS zu erlangen.
  • Zugänglichkeit . Die Geschichte sollte für einen Laien so leicht wie möglich zu verstehen sein. Es gibt praktische Grenzen, wie einfach eine Erklärung eines mathematischen Konzepts sein kann, aber nur wenige Autoren beginnen, sich solchen Grenzen zu nähern. Ein nachdenklicher Kommunikator kann seinen inneren Einstein oder Feynman kanalisieren und viele komplizierte Konzepte relativ leicht verständlich machen. Dies erfordert jedoch Anstrengungen.
  • Kürze . Die Leute sind beschäftigt. Eine Geschichte sollte so kurz wie möglich sein, aber nicht kürzer. Wir können oft Fett abschneiden, ohne viel an Bedeutung zu verlieren. Wir veröffentlichen viele längere Geschichten, wie meine Geschichte über die Geschichte des offenen Internets. Ich habe 3 Monate damit verbracht, es zu recherchieren, und es sollte ursprünglich ein Buch sein, aber ich konnte es so weit reduzieren, dass ich es in einer 26-minütigen Lektüre ausdrücken konnte. Vielleicht gibt es Raum, um es noch weiter zu reduzieren.

Alle diese Tugenden stammen wiederum aus der Realität unserer Moderne: Die Menschen sind beschäftigt .

Wenn die Leute nicht beschäftigt wären, könnten sie mehr daran interessiert sein, ein nostalgisches Stück über den ersten Commodore 64 einer Person zu lesen. Sie könnten bereit sein, sich durch ein paar Lehrbücher für Studenten zu kämpfen, um die mit Fachjargon gefüllte Abhandlung über Cloud Computing zu verstehen. Sie könnten sich Zeit nehmen, um einen mäandrierenden Band eines Artikels anstelle seiner Klippennotizen zu lesen. Aber die meisten Leute sind dafür zu beschäftigt.

Alles, was wir als Redakteure tun, wird durch diese grundlegende Tatsache informiert. Also werde ich es noch einmal sagen. Die Leute sind beschäftigt .

Tools, um das Interesse vielbeschäftigter Menschen zu wecken

Wir haben nur zwei Tools gegen die unerbittliche Schriftrolle von Newsfeeds: eine Überschrift und ein Bild.

So sieht eine Geschichte im Newsfeed von Medium aus:

So sieht es auf Facebook aus:

Und so sieht es auf Twitter aus:

Die Überschrift und das Eröffnungsbild sind die einzigen Dinge, an denen Menschen eine Geschichte beurteilen müssen. Bevor sie den ersten Absatz der Geschichte lesen können, müssen sie eine Frage beantworten. Es ist dieselbe Frage, die wir uns alle jeden Tag stellen: Wird das meine Zeit wert sein?

Ihre erste Aufgabe als Redakteur besteht darin, eine Überschrift und ein Bild auszuwählen, mit denen Leser - vielbeschäftigte Personen, die durch ihre Reddit- oder Facebook-Newsfeeds scrollen - mit "Ja" antworten.

Eine gute Überschrift macht den Unterschied

Die Überschrift ist der wichtigste Teil der Geschichte. Verbringen Sie Zeit damit, es zu verfeinern.

Verwenden Sie keinen Neugier-Lücken-Clickbait: "Sie werden dieses lächerlich effektive dunkle Muster der Überschrift nicht glauben."

Verwenden Sie keine Listenüberschriften und vermeiden Sie im Allgemeinen Artikel, die als Listen strukturiert sind: „11 empörende Überschriften, die die Leute dazu zwingen, Ihre mittlere Geschichte zu lesen.“ (Ich bin schuldig, ein Listacle geschrieben zu haben, und obwohl es allgemein gut aufgenommen wurde, fühle ich mich immer noch faul von mir.)

Sagen Sie die Wahrheit: "Clevere, aber sachliche Überschrift zu einem interessanten Thema."

Wie lang sollten Schlagzeilen sein? HubSpot analysierte 6.000 Blog-Beiträge und stellte fest, dass Geschichten mit 8 bis 14 Wörtern mehr Social-Media-Freigaben erhalten.

Dieser sagte, stellen Sie sicher , die Schlagzeile 80 Zeichen oder weniger . Andernfalls wird der Titel in Newsfeeds abgeschnitten, wenn Personen eine Geschichte auf Facebook und Twitter teilen.

Eine weitere Überlegung ist, wie emotional eine Überschrift ist. Je emotionaler (positiv oder negativ) eine Überschrift ist, desto wahrscheinlicher ist es, dass Menschen darauf klicken.

Überschriften werden traditionell in "Titel" geschrieben. Die Associated Press sagt, dass "der erste Buchstabe jedes Wortes mit Ausnahme von Artikeln, koordinierenden Konjunktionen und Präpositionen von drei Buchstaben oder weniger groß geschrieben werden soll".

Auf Medium werfe ich oft die Groß- und Kleinschreibung aus dem Fenster und schreibe nur Überschriften wie einen normalen Satz. Bei Bedarf füge ich sogar Interpunktion hinzu. Dieses Format ist gesprächiger und leichter zu lesen.

Wir veröffentlichen im Allgemeinen keine mehrteiligen Artikel. Labels wie „Teil 1“ schrecken die Leute ab, denn wer weiß, wann Sie mit dem Schreiben von Teil 2 beginnen. Es ist viel besser, nur eine lange, ausführliche Geschichte oder eine Reihe verwandter, aber eigenständiger Artikel zu veröffentlichen, die dies können von ihren Autoren verlinkt werden.

Verhaftung mit Bildern

Der zweitwichtigste Aspekt einer Geschichte ist das vorgestellte Bild.

Fügen Sie immer mindestens ein Bild in eine Geschichte ein (vorzugsweise ganz oben). Dies hat folgende Vorteile:

  1. Wenn Leute die Geschichte auf Facebook und Twitter teilen, wird sie in Newsfeeds stärker hervorgehoben, wodurch die Wahrscheinlichkeit steigt, dass Leute darauf klicken.
  2. In den eigenen Newsfeeds von Medium wird es besser aussehen.
  3. Menschen sind visuelle Wesen und klicken auf Bilder.

Wenn Sie eine Story veröffentlichen, können Sie mit Medium auswählen, welches Bild das Bild der Story sein soll. Dies bedeutet, dass die og-image-Metaeigenschaft der Geschichte dieses Bild ist. Dieses Bild wird überall als Botschafter der Geschichte fungieren: Social-Media-Newsfeeds, Reddit, Google News - sogar RSS-Reader.

Berücksichtigen Sie Bilder frühzeitig im Bearbeitungsprozess. Und niemals ohne mindestens ein Bild veröffentlichen. Andernfalls ist die Geschichte in Newsfeeds so gut wie unsichtbar.

Sie sollten lange Geschichten mit Bildern auflösen. Um Mary Poppins zu paraphrasieren: Ein Löffel Bilder hilft dabei, den Text nach unten zu bringen.

Medium bietet vier verschiedene Bildbreiten. Beachten Sie, dass diese auf Mobilgeräten alle gleich aussehen.

Meistens sollten Sie sich an die Spaltenbreite halten:

Wenn Sie ein Diagramm haben, das schwer zu lesen ist, wenn es klein ist, gehen Sie größer:

Und wenn Sie wirklich stolz auf ein Bild sind oder wenn es voller interessanter Daten ist, gehen Sie auf Hochtouren:

… Und dann gibt es Side-Straddle. Verwenden Sie diese Größe überhaupt nicht, da der Text dadurch weniger angenehm zu lesen ist.

Es ist auch unangenehm, wenn Sie mit dem Sprechen über das Foto fertig sind und Ihr Text immer noch zur Seite geschoben wird.

Ja. Ich stecke immer noch hier fest.

Wenn Sie einer Story ein Bild hinzufügen müssen, holen Sie sich ein thematisch relevantes Creative Commons Zero-Lizenzbild von pexels.com. Sie können diese kostenlos ohne Namensnennung nutzen.

Bauen Sie mit einem starken Vorsprung Schwung auf

Sobald der Leser die Geschichte durchklickt, beginnt der Prozess. Sie suchen nach einer Ausrede, um zu ihrem Newsfeed zurückzukehren. Weil das Lesen viel mehr Aufwand erfordert als das Scrollen durch Katzenfotos.

Einige Autoren verwenden Intros oder Updates wie "Dies wurde in meinem Blog unter [Blog-URL] veröffentlicht" oder "Update: Dies wurde in Hacker News veröffentlicht." Wenn sie diese hinzugefügt haben, sollten Sie diese Dinge an den Grund der Geschichte verschieben.

Stattdessen sollte der Text sofort Punkte machen und eine Geschichte erzählen.

Helfen Sie dem Autor, seine Glaubwürdigkeit zu etablieren

Finden Sie in den ersten Absätzen heraus, wie Sie die Glaubwürdigkeit des Autors feststellen können. Wenn sie ein Top-Experte auf Ihrem Gebiet sind, sagen Sie es. Gehen Sie nicht davon aus, dass sich die Leute die Zeit nehmen, sie zu googeln.

"Wer du bist, spricht so laut, dass ich nicht hören kann, was du sagst." - Ralph Waldo Emerson

Jede Leistung oder Unterscheidung, die die Menschen dazu bringt, den Schriftsteller ernster zu nehmen, wird den Lesern den Eindruck vermitteln, dass „diese Person weiß, wovon sie spricht“.

Wenn Sie beispielsweise ein ehemaliger Googler / Facebook-Ingenieur sind oder im Kernteam eines beliebten Open-Source-Projekts arbeiten, sollten Sie einen Weg finden, dies auf natürliche Weise zu tun (ohne dass es prahlerisch klingt). "Warum ich Google verlassen habe, um eine persönliche Finanz-App für Kinder zu erstellen" klingt viel überzeugender als "Ich baue eine persönliche Finanz-App, um Kindern zu helfen."

Stärken Sie die Glaubwürdigkeit des Autors während der gesamten Geschichte. Sie sollten ihre Argumente mit Daten unterstützen. Bei Bedarf sollten sie Inline-Links zu (nicht paywalled) Forschung verwenden.

Dies ist nicht das New England Journal of Medicine. Das ist mittel. Verwenden Sie also keine Fußnoten. Wenn der Verfasser Fußnoten verwendet hat, finden Sie heraus, wie Sie diese wieder in den Text einarbeiten können, und entfernen Sie dann die Fußnoten am Ende des Artikels. Oft sind diese Fußnoten nicht umfangreich genug, um aufgenommen zu werden, und können einfach gelöscht werden.

Aussehen und Stil

Führen Sie den Text durch die Hemingway-App. Dieses einfache Tool ist nicht magisch, erkennt jedoch automatisch weitgehend vereinbarte Stilprobleme:

  • passive Stimme
  • unnötige Adverbien
  • Wörter, die häufigere Entsprechungen haben

Adjektive können oft entfernt werden, indem passendere Substantive oder Verben gefunden werden.

Ich stelle fest, dass Sie eine einfache Sprache, kurze Wörter und kurze Sätze verwenden. Das ist der Weg, um Englisch zu schreiben - es ist der moderne Weg und der beste Weg. Bleibe dabei; Lassen Sie nicht zu, dass sich Flusen, Blumen und Ausführlichkeit einschleichen. Wenn Sie ein Adjektiv fangen, töten Sie es. Nein, ich meine nicht ganz, aber töte die meisten von ihnen - dann wird der Rest wertvoll sein. Sie werden schwächer, wenn sie nahe beieinander liegen. Sie geben Kraft, wenn sie weit voneinander entfernt sind. Eine Adjektivgewohnheit oder eine wortreiche, diffuse, blumige Gewohnheit, die einmal an einer Person befestigt ist, ist so schwer loszuwerden wie jedes andere Laster. “ - Mark Twain

Die Hemingway-App weist einer Schrift eine „Klassenstufe“ zu. Sogar technische Geschichten können eine Klassenstufe von 6 erreichen. Und sie sollten danach streben.

Die meisten Menschen sprechen kein Englisch als Muttersprache, und diejenigen, die normalerweise nicht den ganzen Tag Chaucer lesen. Sie wollen, dass ihre Informationen zugänglich und auf den Punkt gebracht werden.

Err auf der Seite, lange Sätze und Absätze in kürzere zu zerlegen.

Ungeachtet dessen, was Sie im Englisch-Kompositionsunterricht gelernt haben, bevorzugen die Leute kurze Absätze gegenüber „Textwänden“.

An Absätzen mit einem Satz ist nichts auszusetzen.

Err auf der Seite der Erstellung neuer Absätze.

Verwenden Sie Kontraktionen. Sie lassen die Prosa gesprächiger erscheinen. Das ist immer ein Plus.

freeCodeCamp ist eine gemeinnützige Organisation mit Sitz in den USA. Daher haben wir uns entschieden, während der gesamten Veröffentlichung amerikanisches Englisch zu verwenden. Möglicherweise müssen Sie gelegentlich "analysieren" in "analysieren" und "Farbe" in "Farbe" ändern.

Beachten Sie auch, dass wir das metrische System dem imperialen System vorziehen.

Buchstabieren Sie die Zahlen eins bis zehn und verwenden Sie dann die Zahlen 11 und höher.

Wenn das Geschlecht einer Person nicht bekannt ist oder der Autor von einer hypothetischen Person spricht, die sie erstellt hat, um einen Punkt zu verdeutlichen, verwenden Sie immer „sie“, „ihre“ und „ihre“. Im modernen Sprachgebrauch fungiert dies auch als singuläres Pronomen der dritten Person. Es ist einfacher als "er oder sie" zu sagen.

Halten Sie die Spannung durchgehend konstant. Wenn der Autor über etwas spricht, das in der Vergangenheit passiert ist, stellen Sie sicher, dass er die Vergangenheitsform verwendet.

Wenn Sie etwas hervorheben möchten, verwenden Sie Fettdruck , aber sparsam . Kursivschrift ist schwerer zu lesen. Keine fett gedruckten Hyperlinks - die Linie darunter bietet bereits genügend Betonung.

Verwenden Sie keine Drop Caps. Sie sehen in alten Büchern elegant aus, aber im Internet albern.

Verwenden Sie jeweils nur ein Ausrufezeichen, normalerweise nur nach Ausrufen wie: Golly gee! Hotdog!

Achten Sie auf falsche „intelligente Anführungszeichen“ wie dieses: „Test“ (beachten Sie, dass beide Anführungszeichen Anführungszeichen öffnen.) Medium fängt diese nicht automatisch ab, daher müssen Sie das Anführungszeichen löschen und erneut eingeben. An diesem Punkt Medium sollte es beheben.

Verwenden Sie immer doppelte Anführungszeichen für umgebende Zitate und alles, was jemand in "Luft-Anführungszeichen" setzen könnte. Verwenden Sie dann einfache Anführungszeichen für Anführungszeichen innerhalb von Anführungszeichen:

„Manchmal, wenn ich Javascript schreibe, möchte ich meine Hände hochwerfen und sagen, das sind Bullen ***! aber ich kann mich nie erinnern, worauf sich 'das' bezieht. “ - Ben Halpern

Beachten Sie, dass ich dort den zweiten Pull-Zitat-Stil von Medium verwendet habe, den wir für Zitate mit einem Absatz verwenden.

Setzen Sie Kommas und Punkte in Anführungszeichen, es sei denn, dies könnte einen Leser verwirren (z. B. mit Variablennamen oder Buchtiteln).

In einigen Teilen der Welt setzen Menschen Leerzeichen vor Doppelpunkte oder Fragezeichen, wie zum Beispiel: Beispiel. Tu das nicht.

Anstatt einen Satz mit "Deshalb" zu beginnen, beginnen Sie ihn mit "So".

Anstatt einen Satz mit "Jedoch" zu beginnen, beginnen Sie ihn mit "Aber".

Verwenden Sie Englisch anstelle von Latein:

  • Verwenden Sie "zum Beispiel" anstelle von "EG"
  • Verwenden Sie "das ist" anstelle von "IE"
  • Verwenden Sie "Beachten Sie das" anstelle von "NB"
  • Anstatt Listen mit "etc." zu beenden Beginnen Sie sie mit „Gefällt mir“: „Elvis isst Essen wie Brot, Erdnussbutter und Bananen.“

Laut Google Books haben Semikolons einen langsamen Tod gestorben.

Lassen Sie uns sie aus ihrem Elend befreien. Verwenden Sie stattdessen einfach einen Punkt und teilen Sie die Klauseln in separate Sätze auf.

Der einzige Platz für Semikolons auf dieser Welt befindet sich am Ende einer Codezeile.

Verwenden Sie nach Möglichkeit das Oxford-Komma. Es macht die Dinge einfacher, klarer und schöner zu lesen.

Anders als bei Code sollten Sie Interpunktion immer wie folgt in Anführungszeichen setzen: Die beliebtesten GitHub-Commit-Nachrichten sind "Initial Commit", "Update readme.md" und "Update".

Auch Front-End - Entwicklung (Adjektivform mit einem Bindestrich) ist , wenn Sie auf der Arbeits Frontend (Substantiv Form ohne Bindestrich). Das gleiche gilt für das Back-End, den Full-Stack und viele andere zusammengesetzte Begriffe.

Showcase-Code

Wenn möglich, sollte der Code eher in Textform als in Bildern vorliegen. Dies macht den Code für Screenreader zugänglicher und für Benutzer einfacher zu kopieren und einzufügen.

Medium hat eine versteckte Verknüpfung, mit der Text wie folgt in einfachen Text umgewandelt wird:

if (Entwickler === true) {

folgen (this.mediumPublication);

}}

… In einen formatierten Codeblock:

if (developer === true) {
follow(this.mediumPublication);
}

Wählen Sie dazu den Text aus und drücken Sie:

  • Windows : Strg + Alt + 6
  • Mac : Befehl + Option + 6
  • Linux : Strg + Alt + 6

Sie können einen Codeblock auch mit dreifachen Back-Ticks starten. Wenn Sie drei Backticks (`` `) in eine neue Zeile eingeben, wechselt Medium in den Code-Eingabemodus.

Um Code inline hervorzuheben, wählen Sie ihn aus und drücken Sie die Backtick-Taste. Auf diese Weise können Sie Text freeCodeCamp()mitten in einem Satz als Code formatieren .

Autoren können sogar ausführbare Apps direkt in Medium einbetten. Nur für den Fall, dass diese in den mobilen Apps von Medium nicht richtig gerendert werden, sollten wir als Fallback Links unter jeder Einbettung einfügen.

Fügen Sie eine CodePen.io-URL in Medium ein und drücken Sie die Eingabetaste:

Sehen Sie sich hier meinen CodePen an.

Sie können dies auch mit JSFiddle.net tun:

Sehen Sie sich hier meine JSFiddle an.

Manchmal beginnen Benutzer Codezeilen mit einem, $wenn es sich um Terminalbefehle handelt. Tu das nicht. Es wird Anfänger verwirren und das Kopieren und Einfügen von Befehlen erschweren. Sagen Sie stattdessen einfach etwas wie "Geben Sie die folgenden Befehle in Ihr Terminal ein."

Lassen Sie Links natürlich aussehen

Finden Sie heraus, wie Sie einen Link in einen Satz einarbeiten können. Eine Sache, die ich nicht empfehle, ist, einen Link in eine eigene Zeile zu setzen und die Eingabetaste zu drücken. Dadurch wird eine gut aussehende Vorschaukarte wie folgt erstellt:

Wie man auf den Schultern von Riesen steht

Erobern Sie das hier nicht erfundene Syndrom und machen Sie dann etwas Neues. medium.freecodecamp.com

… Aber die Leser gehen oft davon aus, dass es sich um Anzeigen handelt, und schauen sie sich nicht einmal an.

Ich würde nur empfehlen, dies am Ende einer Geschichte zu verwenden, wenn Sie einen Link zur weiteren Lektüre erstellen möchten.

Das Unterstreichen von Text erschwert das Lesen, daher werden nur einige Wörter verlinkt.

Fügen Sie URLs nicht direkt wie folgt ein: ❌ //www.freecodecamp.org ❌

Verlinken Sie stattdessen auf Websites wie freeCodeCamp mid satz, wie ich es gerade hier getan habe.

Medien einbetten

Sie können Tweets, YouTube-Videos und andere Medien einbetten, indem Sie deren URLs in einer neuen Zeile in Medium einfügen und dann die Eingabetaste drücken.

Verwenden Sie diese sparsam, da sie Ihren Leser davon abhalten können, Ihre Geschichte zu beenden.

Erklären Sie Abkürzungen

Verwenden Sie keine Abkürzung, es sei denn, die Abkürzung wird besser verstanden als das, wofür sie steht. Beispielsweise ist HTTP allgemein anerkannt als das Hypertext Transfer Protocol.

Wenn eine Abkürzung noch nicht allgemein verstanden ist und Sie mehr als ein paar Mal darauf verweisen, können Sie sie folgendermaßen als Abkürzung definieren:

"Lassen Sie uns den Code in einen abstrakten Syntaxbaum (AST) aufteilen."

Hier habe ich der Einfachheit halber auch auf den Wikipedia-Artikel verlinkt. Gehen Sie jedoch nicht davon aus, dass Personen diese externen Links lesen. Sie müssen noch Konzepte definieren oder anhand eines Beispiels veranschaulichen.

Vermeiden Sie es, in Ihren ersten Absätzen eine Abkürzung zu definieren, da dies Ihren Leser verlangsamt und die Wahrscheinlichkeit verringert, dass er weiter liest.

Hier ist die sehr kurze Liste der Technologie-Abkürzungen, die Sie nicht definieren müssen: API, AJAX, BIOS, CPU, CSS, HTML, HTTPS, JSON, LAN, RAM, REST, USB, WWW, XML. Für alles andere sollten Sie es buchstabieren.

Buchstabieren Sie immer kurze mehrteilige Wörter wie JavaScript und Frontend. Kürzen Sie sie nicht. Die Kürze ist die mögliche Verwirrung nicht wert.

Fügen Sie 5 Tags hinzu

Mit Mittel können Sie einer Story bis zu fünf Tags hinzufügen. Benutze sie.

Menschen folgen bestimmten Themen auf Medium. Die beliebtesten sind #tech, # life-Lessons, #travel, #design und #startup.

Personen, die den von Ihnen verwendeten Tags folgen, sehen die Geschichte möglicherweise in ihrem Newsfeed. Tags erleichtern es den Nutzern auch, in den Suchergebnissen über die Geschichte zu stolpern.

Wenn ein Autor ein Tag ausgewählt hat, das nicht sehr beliebt ist, können Sie es durch die beliebtere Variante ersetzen. Zum Beispiel ist "JS" ein weitaus weniger beliebtes Tag als "JavaScript". "UXD" und "UX Design" sind weit weniger beliebt als "UX".

Sie sollten auch so unterschiedliche Tags wie möglich verwenden (vorausgesetzt, sie sind für den Artikel relevant). Beispielsweise benötigt ein Artikel über die Android-Entwicklung nicht "Android", "AndroidDev" und "Android Apps". Die Leser, die "AndroidDev" folgen, folgen wahrscheinlich auch "Android", so dass es eine Verschwendung von wertvollem Tag-Immobilien ist. Stattdessen können Sie populärere verwandte Tags wie "Programmierung" und "Technologie" hinzufügen.

Akzeptables Maß an Eigenwerbung

Schriftsteller schreiben, um Wissen zu verbreiten, aber die meisten von ihnen haben auch zusätzliche Motivationen.

Einige Autoren versuchen, für ihr Open-Source-Projekt oder Startup zu werben oder die Tatsache bekannt zu machen, dass sie einstellen. Einige Autoren versuchen, Leute dazu zu bringen, ihnen auf Twitter zu folgen oder sich für ihre Mailingliste anzumelden.

All diese Dinge sind in Ordnung. Aber sie sollten im Rahmen der Vernunft und in der Fußzeile des Artikels erfolgen.

Es ist in Ordnung für Leute, Artikel aus ihrem eigenen Blog zu veröffentlichen, aber eine Sache, die sie manchmal nicht tun sollten, ist, ihre Überschrift in einen Link zu ihrem Blog-Beitrag zu verwandeln. In einigen Fällen kann dies unbeabsichtigt sein, aber wir sollten diesen Link entfernen.

Viele Autoren werden auch am Ende ihres Artikels nach Klatschen fragen. Dies wird dazu beitragen, die Anzahl der Personen zu erhöhen, die den Artikel im Empfehlungssystem von Medium sehen. Das ist auch gut so.

Das Medium hat sich kürzlich von Herzen zu Klatschen gewandelt. Aber viele Schriftsteller fragen immer noch nach Herzen. Ändern Sie daher unbedingt ihre Anforderungen, um stattdessen Klatschen zu erwähnen.

Hier ist beispielsweise eine Zeile, die Sie verwenden könnten: "Wenn Sie diesen Artikel hilfreich fanden, klatschen Sie mir?"

Dinge, auf die Sie als Redakteur achten sollten

Plagiat

Plagiate - wenn jemand das Schreiben eines anderen als sein eigenes falsch darstellt - sind in der Wissenschaft ein schwerwiegendes Vergehen, und auf Medium ist es genauso schwerwiegend. Autoren sollten den Personen, die sie ursprünglich gesagt haben, immer Zitate zuweisen.

Wenn es sich um ein mehrzeiliges Zitat handelt, sollten Sie die Pull-Anführungszeichen von Medium verwenden:

"Wenn Sie Ihren eigenen Witz haben, ist es eine Freude, andere Menschen für ihren zu würdigen." - Criss Jami

Wenn Sie Plagiate vermuten - zum Beispiel einen Absatz mit perfektem Englisch in einem Artikel, der ansonsten unnatürlich liest, oder etwas, das in einem ansonsten trockenen Artikel außergewöhnlich witzig erscheint - nehmen Sie den verdächtigen Absatz und fügen Sie ihn in Google ein. Dies ist eine bequeme erste Verteidigungslinie.

Wenn eine Passage plagiiert zu sein scheint, beenden Sie die Bearbeitung. Wir werden es nicht veröffentlichen. Senden Sie mir eine E-Mail, um mich zu informieren. Ich werde die unangenehme Aufgabe übernehmen, dem Autor ein „echtes Gespräch“ für Sie zu geben.

Gatekeeping

"Gatekeeping ist, wenn jemand selbst entscheidet, wer Zugang oder Rechte zu einer Community oder Identität hat oder nicht." - Urban Dictionary

Gatekeeping ist eine Form des Elitismus und widerspricht unserem Prinzip der Zugänglichkeit. Wenn Sie besser verstehen möchten, was Gatekeeping ist, hat Reddit einen Subreddit mit einigen traurigen (und gelegentlich ironischen) Beispielen.

Oft merken Schriftsteller nicht, dass sie Gatekeeping sind. Hier sind einige Ausdrücke, die sie verwenden können:

  • offensichtlich
  • einfach [etwas tun]
  • natürlich [etwas ist so und so]
  • wie jeder weiß
  • wie du wahrscheinlich gehört hast
  • [etwas] ist einfach
  • Jeder ["Idiot", "Narr", "Neuling", "Script Kiddie" usw.] kann [etwas tun]

Wenn Sie Gatekeeping sehen, entfernen Sie es einfach. Die meisten dieser Ausdrücke fügen dem Artikel nichts hinzu.

Diskriminierung

Wir haben einen strengen Verhaltenskodex, der verhindern soll, dass Menschen aufgrund von „Geschlecht, Geschlechtsidentität und -ausdruck, Alter, sexueller Orientierung, Behinderung, körperlichem Erscheinungsbild, Körpergröße, Rasse, nationaler Herkunft oder Religion (oder) diskriminiert werden deren Fehlen)."

Wenn Sie etwas sehen, von dem Sie glauben, dass es Diskriminierung darstellt, entfernen Sie es. Nicht jede Kultur nimmt diese Dinge mit der gleichen Ernsthaftigkeit wie die Amerikaner. Aber wenn Sie der Meinung sind, dass es kein Missverständnis ist und der Autor absichtlich diskriminierend ist, machen Sie mich bitte darauf aufmerksam.

Unnötige Obszönität

Wir werden von Publikum jeden Alters häufig gelesen, daher versuchen wir, überhaupt keine Obszönitäten zu veröffentlichen.

Leichte Obszönitätswörter wie „verdammt“ und Ausdrücke wie „was zur Hölle“ sind akzeptabel.

In den meisten Fällen gibt es eine weniger profane Alternative zu profanen Phrasen, die dasselbe bedeuten und ähnliche Emotionen vermitteln.

Manchmal wird das f-Wort beispielsweise als Adjektiv eingefügt, was grundsätzlich unnötig ist. Menschen verwenden das S-Wort oft als Synonym für „schlecht“, und dies kann auch durch etwas weniger Profanes ersetzt werden. Der Ausdruck "BS" bedeutet im Grunde "unwahr" oder "Lüge".

Wir sind eine technische Publikation, daher wird das Schreiben in den meisten Fällen nicht sehr heiß. Im Zweifelsfall können Sie **** verwenden, um einen Teil des beleidigenden Wortes zu ersetzen.

Post-Publishing-Prozess

Nachdem wir einen Artikel veröffentlicht haben, helfen wir, ihn auf Twitter, Facebook und LinkedIn zu veröffentlichen. Wir verwenden Buffer, um alle diese Posts so zu planen, dass sie zum bestmöglichen Zeitpunkt veröffentlicht werden.

Vor der Veröffentlichung führen wir die Artikel über den Debugger von Facebook und den Kartenvalidator von Twitter aus. Wenn sie gut aussehen und einsatzbereit sind, klicken wir im veröffentlichten Medium-Artikel auf das Symbol „Tweet“, kopieren den Text des Tweets und laden diesen Text in Buffer.

Bei Twitter-Posts entfernen wir einfach die Anführungszeichen um den Artikeltitel und fügen nach dem Titel ein Komma hinzu (wenn am Ende keine andere Interpunktion steht). Wenn Medium den Autor über sein Twitter-Handle anruft, belassen wir dort das "by @username". Wenn nur der vollständige Name verwendet wird, löschen wir den Teil "Nach [Vorname] [Nachname]" aus dem Tweet.

Bei LinkedIn- und Facebook-Posts entfernen wir die Anführungszeichen aus dem Titel und löschen den Rest des Textes, wobei nur der Titel des Posts und der Link übrig bleiben.

Sobald wir diese Beiträge gepuffert haben, betrachten wir diesen Artikel als beendet.

Fazit

Vielen Dank, dass Sie diesen Leitfaden gelesen haben. Wenn Sie Vorschläge haben, wie es verbessert werden kann, lassen Sie es mich wissen. Hoffentlich wird dieser Leitfaden um zusätzliche redaktionelle Überlegungen und häufig auftretende Randfälle erweitert.

Dies ist eine Beispielfußzeile für einen mittleren Artikel.

Danke fürs Lesen. Wenn Sie darüber nachdenken, hinterlassen Sie unbedingt einen Kommentar.

Wenn Sie diesen Artikel hilfreich fanden, geben Sie mir ein paar Klatschen?

Und du kannst mir hier auf Twitter folgen.