Manuale dell'editor di pubblicazioni medie di freeCodeCamp

Nota: freeCodeCamp non è più attivo su Medium. Ora stiamo usando il nostro strumento di blogging Ghost open source self-hosted. Probabilmente stai leggendo questo su freeCodeCamp News in questo momento?. Ma questo potrebbe comunque esserti utile se scegli di pubblicare su Medium.

La comunità open source freeCodeCamp una volta gestiva la più grande pubblicazione tecnica di Medium. Ogni settimana, abbiamo pubblicato più di una dozzina di storie su sviluppo, progettazione e scienza dei dati.

Per molto tempo sono stato l'unico editore della pubblicazione. Ho modificato e pubblicato più di 1.200 contributi. Ma abbiamo sempre ricevuto molte più proposte di storie di alta qualità di quante ne avessi avuto il tempo di pubblicare. Così ho finalmente ammesso a me stesso che avevo bisogno di aiuto.

Anche se freeCodeCamp raggiunge milioni di persone ogni mese tramite Medium, YouTube e la nostra piattaforma di codifica, siamo una piccola organizzazione non profit supportata da donatori. Ci mancano le risorse per assumere editori professionisti.

Detto questo, la mancanza di risorse non ci ha fermato in altre aree. Abbiamo migliaia di volontari che gestiscono gruppi di studio locali, contribuiscono a progetti open source e moderano forum e chat.

Così all'inizio di luglio ho pubblicato un invito per redattori volontari. Hanno risposto più di 50 persone. E da quegli intervistati, ho riunito e formato un piccolo team di redattori.

Allo stesso tempo, ho redatto quello che alla fine sarebbe diventato questo Manuale dell'Editore. Questa è la nostra guida su come il nostro team di editor volontari modifica le storie. E in uno spirito di trasparenza, lo sto rendendo pubblico.

Può essere utile se modifichi una rivista tecnica o una pubblicazione Medium. Oppure, se sei uno degli oltre 500 scrittori che sono stati pubblicati nella pubblicazione freeCodeCamp, potresti essere curioso di sapere cosa succede dietro le quinte.

Ad ogni modo, spero che troverai questo documento vivente interessante e utile.

Come valutiamo, modifichiamo e pubblichiamo le storie

Riceviamo dozzine di proposte ogni settimana e proteggiamo il tempo dei nostri lettori. Cerchiamo di pubblicare solo storie che sono:

  • ben scritta
  • pertinente per il nostro pubblico di sviluppatori , designer e data scientist
  • fattuali e non principalmente scritti per promuovere un prodotto o un'azienda

La realtà della pubblicazione di articoli nel 21 ° secolo

Le persone sono impegnate. Non sono mai stati così impegnati. E le cose andranno peggio prima di migliorare.

Dobbiamo ottimizzare per il tempo scarso dei nostri lettori.

Nel giornalismo giornalistico tradizionale, ciò significa utilizzare la piramide invertita, mettendo al primo posto i fatti più importanti e aggiungendo altri fatti in ordine decrescente di importanza. In questo modo, se qualcuno smette di leggere, se ne andrà comunque con l'idea principale e quanti più fatti importanti possibili.

La maggior parte delle storie di Medium assomigliano più da vicino alle storie di funzionalità. Raccontano eventi (post-mortem del progetto, rapporti su come ottenere un lavoro) o argomentano un punto (esponendo le vulnerabilità della sicurezza, approvando l'uso di una particolare libreria per uno scopo specifico).

Un'altra categoria è rappresentata dai tutorial. Questi possono riguardare qualsiasi cosa, da come riparare una testa staccata in Git, a come costruire un'abilità Alexa senza server.

Indipendentemente dal tipo di storia - notizie, funzionalità, tutorial - dovrebbero tutti tendere per le stesse virtù:

  • Sostanza .La storia dovrebbe portare qualcosa di significativo in tavola. La storia di uno scrittore sul Commodore 64 che i loro genitori hanno comprato per loro negli anni '80 potrebbe essere di grande interesse per loro personalmente, ma sarà rilevante per un lettore tipico? Se ne andranno con qualcosa di utile? D'altra parte, quasi tutti i nostri lettori trarrebbero beneficio dall'apprendimento di più sul processo del colloquio di lavoro o dall'acquisizione di una migliore comprensione di come funzionano i CSS.
  • Accessibilità . La storia dovrebbe essere il più facile possibile da capire per un laico. Ci sono limiti pratici alla semplicità di una spiegazione di un concetto matematico, ma pochi scrittori iniziano ad avvicinarsi a tali limiti. Un comunicatore premuroso può canalizzare il proprio Einstein o Feynman interiore e rendere relativamente facili da capire molti concetti complicati. Ma questo richiede uno sforzo.
  • Brevità . Le persone sono impegnate. Una storia dovrebbe essere la più breve possibile, ma non più breve. Spesso possiamo tagliare il grasso senza sacrificare molto in termini di significato. Pubblichiamo molte storie più lunghe, come la mia storia sulla storia di Internet aperto. Ho passato 3 mesi a ricercarlo, e originariamente sarebbe stato un libro, ma sono stato in grado di ridurlo al punto da poterlo esprimere in una lettura di 26 minuti. Forse c'è spazio per ridurlo ulteriormente.

Ancora una volta, tutte queste virtù derivano dalla realtà della nostra epoca moderna: le persone sono impegnate .

Se le persone non fossero occupate, potrebbero essere più interessate a leggere un pezzo nostalgico sul primo Commodore 64 di qualcuno. Potrebbero essere disposte a lottare attraverso alcuni libri di testo universitari in modo da poter capire il trattato pieno di gergo sul cloud computing di qualcuno. Potrebbero trovare il tempo per leggere un tortuoso tomo di un articolo invece dei suoi appunti. Ma la maggior parte delle persone è troppo occupata per questo.

Tutto ciò che facciamo come redattori è informato da questo fatto fondamentale. Quindi lo dirò di nuovo. Le persone sono impegnate .

Strumenti per attirare l'interesse di persone impegnate

Abbiamo solo due strumenti contro l'inesorabile scorrimento dei feed di notizie: un titolo e un'immagine.

Ecco come appare una storia nel feed di notizie di Medium:

Ecco come appare su Facebook:

Ed ecco come appare su Twitter:

Il titolo e l'immagine di apertura sono le uniche cose su cui le persone devono giudicare una storia. Prima ancora di poter leggere il primo paragrafo della storia, devono rispondere a una domanda. È la stessa domanda che ci poniamo tutti ogni giorno: ne varrà la pena?

Il tuo primo lavoro come editore è scegliere un titolo e un'immagine che rendano i lettori - persone impegnate a scorrere il loro Reddit o i loro feed di notizie di Facebook - rispondere "sì".

Un buon titolo fa la differenza

Il titolo è la parte più importante della storia. Dedica del tempo a perfezionarlo.

Non usare clickbait per curiosità: "Non crederai a questo modello scuro del titolo ridicolmente efficace".

Non utilizzare titoli di elenchi e in genere evita articoli strutturati come elenchi: "11 titoli oltraggiosi che costringeranno le persone a leggere la tua storia di Medium". (Sono colpevole di aver scritto un listacolo, e anche se è stato generalmente ben accolto, sento ancora che è stato pigro da parte mia.)

Dì la verità: "Titolo intelligente ma pratico su un argomento interessante".

Quanto dovrebbero essere lunghi i titoli? HubSpot ha analizzato 6.000 post del blog e ha scoperto che le storie con titoli da 8 a 14 parole ottengono più condivisioni sui social media.

Detto questo, assicurati che il titolo contenga 80 caratteri o meno . In caso contrario, il titolo verrà troncato nei feed di notizie quando le persone condividono una storia su Facebook e Twitter.

Un'altra considerazione è quanto sia emotivo un titolo. Più un titolo è emotivo (positivo o negativo), più è probabile che le persone facciano clic su di esso.

I titoli sono tradizionalmente scritti in "caso del titolo". L'Associated Press afferma di "scrivere in maiuscolo la prima lettera di ogni parola eccetto articoli, congiunzioni di coordinamento e preposizioni di tre lettere o meno".

Su Medium, spesso butto il caso del titolo fuori dalla finestra e scrivo i titoli come una normale frase. Includo anche la punteggiatura se necessario. Questo formato è più colloquiale e più facile da leggere.

Generalmente non pubblichiamo articoli in più parti. Etichette come "parte 1" spaventano le persone, perché chissà quando inizierai a scrivere la parte 2. È molto meglio pubblicare semplicemente una storia lunga e approfondita o una serie di articoli correlati ma indipendenti che possono essere interconnessi dai loro autori.

Arresto con immagini

Il secondo aspetto più importante di una storia è la sua immagine in primo piano.

Includi sempre almeno un'immagine in una storia (preferibilmente all'inizio). Ciò ha i seguenti vantaggi:

  1. Quando le persone condividono la storia su Facebook e Twitter, sarà più evidente nei feed di notizie, rendendo le persone più propense a fare clic su di essa.
  2. Avrà un aspetto migliore nei feed di notizie di Medium.
  3. Gli esseri umani sono creature visive e fanno clic sulle immagini.

Quando pubblichi una storia, Medium ti consente di scegliere quale immagine desideri sia l'immagine in primo piano della storia. Ciò significa che la meta proprietà og-image della storia sarà questa immagine. Questa immagine fungerà da ambasciatore della storia ovunque: feed di notizie sui social media, Reddit, Google News e persino lettori RSS.

Inizia a considerare le immagini nelle prime fasi del processo di modifica. E non pubblicare mai senza almeno un'immagine. Altrimenti la storia sarà quasi invisibile nei feed di notizie.

Dovresti spezzare storie lunghe con immagini. Per parafrasare Mary Poppins, un cucchiaio di immagini aiuta il testo a scendere.

Medium offre quattro diverse larghezze di immagine. Tieni presente che saranno tutti uguali sui dispositivi mobili.

Il più delle volte, ti consigliamo di mantenere la larghezza della colonna:

Se hai un grafico difficile da leggere quando è piccolo, ingrandiscilo:

E se sei davvero orgoglioso di un'immagine, o se è piena zeppa di dati interessanti, vai al vivo:

... e poi c'è il side-straddle. Non utilizzare affatto questa dimensione, perché rende il testo meno comodo da leggere.

È anche imbarazzante quando hai finito di parlare della foto e il tuo testo è ancora spinto di lato.

Si. Sono ancora bloccato qui.

Se devi aggiungere un'immagine a una storia, prendi un'immagine con licenza Creative Commons Zero tematicamente rilevante da pexels.com. Puoi usarli gratuitamente senza attribuzione.

Crea slancio con un forte vantaggio

Una volta che il lettore fa clic sulla storia, inizia il processo. Stanno cercando una scusa per tornare al loro feed di notizie. Perché leggere richiede molto più impegno che scorrere le foto dei gatti.

Alcuni scrittori utilizzano introduzioni o aggiornamenti come "Questo è stato pubblicato sul mio blog all'indirizzo [URL del blog]" o "Aggiornamento: questo è stato pubblicato su Hacker News". Se li hanno aggiunti, dovresti spostare questi elementi in fondo alla storia.

Invece, il testo dovrebbe iniziare a fare punti e raccontare una storia immediatamente.

Aiuta lo scrittore a stabilire la propria credibilità

Trova un modo per stabilire la credibilità dello scrittore nei primi paragrafi. Se sono i massimi esperti nel tuo campo, dillo. Non dare per scontato che le persone si prenderanno il tempo per cercarle su Google.

"Chi sei parla così forte che non riesco a sentire cosa stai dicendo." - Ralph Waldo Emerson

Qualsiasi risultato o distinzione che induca le persone a prendere lo scrittore più sul serio contribuirà a dare ai lettori l'impressione che "questa persona sappia di cosa sta parlando".

Ad esempio, se sono un ex ingegnere di Google / Facebook o fanno parte del team principale di un popolare progetto open source, dovresti trovare un modo per farlo in modo naturale (senza che suoni vanaglorioso). "Perché ho lasciato Google per creare un'app di finanza personale per bambini" sembra molto più convincente di "Sto creando un'app di finanza personale per aiutare i bambini".

Rafforza la credibilità dello scrittore in tutta la storia. Dovrebbero supportare i loro argomenti con i dati. Se necessario, dovrebbero utilizzare collegamenti in linea alla ricerca (non protetta da paywall).

Questo non è il New England Journal of Medicine. Questo è Medium. Quindi non utilizzare note a piè di pagina. Se l'autore ha utilizzato le note a piè di pagina, trova un modo per inserirle nel testo, quindi rimuovi le note a piè di pagina alla fine dell'articolo. Molte volte, queste note a piè di pagina non sono abbastanza sostanziali da essere incluse e possono essere semplicemente cancellate.

Look e stile

Esegui il testo tramite l'app Hemingway. Non c'è niente di magico in questo semplice strumento, ma rileverà automaticamente problemi di stile ampiamente condivisi:

  • voce passiva
  • avverbi non necessari
  • parole che hanno equivalenti più comuni

Gli aggettivi possono spesso essere rimossi trovando nomi o verbi più appropriati.

"Ho notato che usi un linguaggio semplice e semplice, parole brevi e frasi brevi. Questo è il modo di scrivere in inglese - è il modo moderno e il modo migliore. Attenersi ad essa; non lasciare che lanugine, fiori e verbosità si insinuino. Quando prendi un aggettivo, uccidilo. No, non intendo assolutamente, ma uccidi la maggior parte di loro - poi il resto sarà prezioso. Si indeboliscono quando sono vicini tra loro. Danno forza quando sono molto distanti. Un'abitudine aggettivo, o un'abitudine prolissa, diffusa, fiorita, una volta fissata su una persona, è difficile da eliminare come qualsiasi altro vizio. " - Mark Twain

L'app Hemingway assegnerà un "livello di voto" a un pezzo di scrittura. Anche le storie tecniche possono portare a un livello di 6. E dovrebbero aspirare.

La maggior parte degli umani non è di madrelingua inglese, e quelli che di solito non sono seduti a leggere Chaucer tutto il giorno. Vogliono che le loro informazioni siano accessibili e pertinenti.

Pensa a spezzare frasi lunghe e paragrafi in frasi più brevi.

Nonostante quello che potresti aver imparato durante il corso di composizione inglese, le persone preferiscono i paragrafi brevi ai "muri di testo".

Non c'è niente di sbagliato nei paragrafi di una sola frase.

Pensa dalla parte della creazione di nuovi paragrafi.

Usa le contrazioni. Faranno sembrare la prosa più colloquiale. È sempre un vantaggio.

freeCodeCamp è un'organizzazione no profit con sede negli Stati Uniti, quindi abbiamo scelto di utilizzare l'inglese americano per tutta la pubblicazione. Potrebbe essere necessario modificare l'occasionale "analisi" in "analizzare" e "colore" in "colore".

Si noti inoltre che preferiamo il sistema metrico a quello imperiale.

Scrivi i numeri da uno a dieci, quindi usa i numeri da 11 in su.

Quando il sesso di qualcuno non è noto - o l'autore sta parlando di una persona ipotetica che hanno creato per il gusto di fare un punto - usa sempre "loro", "loro" e "loro". Nell'uso moderno, questo funziona anche come pronome singolare in terza persona. È più semplice che dire "lui o lei".

Mantieni la tensione costante per tutto il tempo. Se lo scrittore sta parlando di qualcosa che è accaduto in passato, assicurati che usi il passato.

Se vuoi enfatizzare qualcosa, usa il grassetto , ma usalo con parsimonia . Il corsivo è più difficile da leggere. Non utilizzare collegamenti ipertestuali in grassetto: la riga sottostante fornisce già un'enfasi sufficiente.

Non utilizzare capolettera. Sembrano eleganti nei vecchi libri, ma stupidi sul web.

Usa solo un punto esclamativo alla volta, in genere solo dopo esclamazioni come: Golly gee! Hot dog!

Cerca le "virgolette intelligenti" errate come questa: "test" (nota che entrambe le virgolette sono virgolette di apertura.) Mezzo non le cattura automaticamente, quindi dovrai eliminare e ridigitare la citazione, a quel punto Medio dovrebbe risolverlo.

Utilizza sempre virgolette doppie per le citazioni circostanti e qualsiasi cosa che qualcuno potrebbe inserire tra "virgolette aeree" Quindi utilizzare virgolette singole per citazioni all'interno di citazioni:

"A volte, quando scrivo Javascript, voglio alzare le mani e dire 'questo è stronzo!' ma non riesco mai a ricordare a cosa si riferisce "questo". " - Ben Halpern

Nota che ho usato il secondo stile di virgolette pull di Medium, che usiamo per le citazioni di un paragrafo.

Metti virgole e punti tra virgolette, tranne quando potrebbero confondere un lettore (come con nomi di variabili o titoli di libri).

In alcune parti del mondo, le persone mettono spazi prima dei due punti o dei punti interrogativi, in questo modo: esempio. Non farlo.

Invece di iniziare una frase con "Pertanto", inizia con "Così".

Invece di iniziare una frase con "Tuttavia", inizia con "Ma".

Usa l'inglese invece del latino:

  • Usa "for example" invece di "EG"
  • Usa "that is" invece di "IE"
  • Utilizza "nota che" invece di "NB"
  • Invece di terminare gli elenchi con "ecc." inizia con "mi piace": "Elvis mangia cibo come pane, burro di arachidi e banane".

Secondo Google Libri, i punti e virgola stanno morendo di una lenta morte.

Mettiamoli fuori dalla loro miseria. Usa invece un punto e spezza le clausole in frasi separate.

L'unico posto per il punto e virgola in questo mondo è alla fine di una riga di codice.

Usa la virgola di Oxford quando possibile. Rende le cose più facili, più chiare e più belle da leggere.

A differenza del codice, dovresti sempre inserire la punteggiatura tra virgolette, in questo modo: i messaggi di commit di GitHub più popolari sono "commit iniziale", "aggiornamento readme.md" e "aggiornamento".

Inoltre, lo sviluppo front-end (forma aggettivo con un trattino) è quando lavori sul front-end (forma sostantivo senza trattino). Lo stesso vale per il back-end, lo stack completo e molti altri termini composti.

Codice della vetrina

Ove possibile, il codice dovrebbe essere in forma di testo anziché in immagini. Ciò rende il codice più accessibile agli screen reader e più facile da copiare e incollare.

Medium ha una scorciatoia nascosta che trasformerà il testo in testo normale in questo modo:

if (sviluppatore === true) {

follow (this.mediumPublication);

}

... in un blocco di codice formattato:

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

A tale scopo, seleziona il testo, quindi premi:

  • Windows : Control + Alt + 6
  • Mac : Comando + Opzione + 6
  • Linux : Ctrl + Alt + 6

Puoi anche avviare un blocco di codice con tripli back-tick. Se digiti tre backtick (`` ``) su una nuova riga, Medium passerà alla modalità di immissione del codice.

Per evidenziare il codice in linea, selezionalo, quindi premi il tasto backtick. In questo modo, puoi formattare il testo come codice freeCodeCamp()proprio nel mezzo di una frase.

Gli scrittori possono persino incorporare app eseguibili direttamente in Medium. Nel caso in cui questi non vengano visualizzati correttamente nelle app mobili di Medium, dovremmo includere collegamenti sotto ciascuno degli incorporamenti come riserva.

Incolla un URL CodePen.io in Medium, quindi premi invio:

Visualizza il mio CodePen qui.

Puoi farlo anche con JSFiddle.net:

Visualizza il mio JSFiddle qui.

A volte le persone iniziano le righe di codice con un $se sono comandi da terminale. Non farlo. Confonderà i principianti e renderà più difficile copiare e incollare i comandi. Dì invece qualcosa come "Inserisci i seguenti comandi nel tuo terminale".

Rendi naturali i collegamenti

Trova un modo per inserire un collegamento in una frase. Una cosa che non consiglio di fare è inserire un collegamento su una riga separata e premere Invio. Questo creerà una bella scheda di anteprima, come questa:

Come stare sulle spalle dei giganti

Conquista la sindrome non inventata qui, quindi fai qualcosa di nuovo. medium.freecodecamp.com

... ma i lettori spesso danno per scontato che si tratti di pubblicità e non le guardano nemmeno.

L'unica volta che consiglierei di usarlo è alla fine di una storia, se vuoi collegarti a ulteriori letture.

La sottolineatura del testo rende più difficile la lettura, quindi collega solo poche parole.

Non incollare direttamente gli URL, in questo modo: ❌ //www.freecodecamp.org ❌

Invece link a siti come freeCodeCamp a metà frase, come ho appena fatto qui.

Incorpora media

Puoi incorporare Tweet, video di YouTube e altri media incollando i loro URL in Medio su una nuova riga, quindi premendo Invio.

Usali con parsimonia, poiché potrebbero distrarre il tuo lettore dal finire la tua storia.

Spiega le abbreviazioni

Non utilizzare un'abbreviazione a meno che l'abbreviazione non sia compresa più ampiamente di ciò che rappresenta. Ad esempio, HTTP è più ampiamente riconosciuto rispetto a Hypertext Transfer Protocol.

Se un'abbreviazione non è già ampiamente compresa e la farai riferimento più volte, puoi definirla come un'abbreviazione in questo modo:

"Suddividiamo il codice in un albero sintassi astratto (AST)."

Qui ho anche collegato l'articolo di Wikipedia, per comodità dei lettori. Non dare per scontato che le persone leggeranno questi link esterni, però. Hai ancora bisogno di definire concetti o illustrarli attraverso l'esempio.

Evita di definire un'abbreviazione nei paragrafi iniziali, poiché rallenta il lettore e rende meno probabile che continui a leggere.

Ecco un breve elenco di abbreviazioni tecnologiche che non è necessario definire: API, AJAX, BIOS, CPU, CSS, HTML, HTTPS, JSON, LAN, RAM, REST, USB, WWW, XML. Per tutto il resto, dovresti spiegarlo.

Scrivi sempre parole brevi in ​​più parti come JavaScript e front-end. Non accorciarli. La brevità non vale la possibile confusione.

Aggiungi 5 tag

Medium ti consente di aggiungere fino a cinque tag a una storia. Usali.

Le persone seguono argomenti specifici su Medium. I più popolari sono #tech, # life-lesson, #travel, #design e #startup.

Le persone che seguono i tag che utilizzi potrebbero vedere la storia nel loro feed di notizie. I tag rendono anche più facile per le persone incappare nella storia nei risultati di ricerca.

Se uno scrittore ha scelto un tag che non è molto popolare, puoi sostituirlo con la variante più popolare. Ad esempio "JS" è un tag molto meno popolare di "JavaScript". "UXD" e "UX Design" sono molto meno popolari di "UX".

Dovresti anche utilizzare tag il più possibile diversi (supponendo che siano pertinenti all'articolo). Ad esempio, un articolo sullo sviluppo di Android non necessita di "Android", "AndroidDev" e "App Android". I lettori che stanno seguendo "AndroidDev" probabilmente stanno seguendo anche "Android" quindi è uno spreco di preziose proprietà di tag. Puoi invece aggiungere tag correlati più popolari come "programmazione" e "tecnologia".

Livelli accettabili di auto promozione

Gli scrittori scrivono per diffondere la conoscenza, ma la maggior parte di loro ha anche motivazioni aggiuntive.

Alcuni scrittori stanno cercando di promuovere il loro progetto o avvio open source, o pubblicizzare il fatto che stanno assumendo. Alcuni scrittori stanno cercando di convincere le persone a seguirli su Twitter o a iscriversi alla loro mailing list.

Tutte queste cose vanno bene. Ma dovrebbero essere fatti entro limiti ragionevoli e nel piè di pagina dell'articolo.

Va bene che le persone postino articoli dal proprio blog, ma una cosa che a volte non dovrebbero fare è trasformare il titolo in un collegamento al post del blog. In alcuni casi ciò potrebbe non essere intenzionale, ma dovremmo rimuovere quel collegamento.

Molti scrittori chiederanno anche applausi alla fine del loro articolo. Ciò contribuirà ad aumentare il numero di persone che vedono l'articolo all'interno del sistema di raccomandazione di Medium. Anche questo va bene.

Medium recentemente cambiato da cuori ad applausi. Ma molti scrittori chiedono ancora i cuori. Quindi assicurati di cambiare le loro richieste per menzionare invece gli applausi.

Ad esempio, ecco una riga che potresti usare: "Se hai trovato utile questo articolo, dammi qualche applauso?"

Cose a cui prestare attenzione come editore

Plagio

Il plagio - quando qualcuno travisa la scrittura di qualcun altro come propria - è un grave reato nel mondo accademico, ed è altrettanto grave su Medium. Gli scrittori dovrebbero sempre attribuire le citazioni alle persone che le hanno pronunciate originariamente.

Se si tratta di una citazione su più righe, dovresti usare le virgolette di Medium:

"Quando hai il tuo spirito, è un piacere dare credito ad altre persone per il loro." - Criss Jami

Se sospetti un plagio, ad esempio un paragrafo di un inglese perfetto in un articolo che altrimenti si legge in modo innaturale o qualcosa che sembra eccezionalmente arguto in un articolo altrimenti secco, prendi il paragrafo sospetto e incollalo in Google. Questa è una comoda prima linea di difesa.

Se un passaggio sembra essere plagiato, interrompi la modifica. Non lo pubblicheremo. Mandami una mail per farmi sapere. Gestirò lo spiacevole compito di dare all'autore un "discorso vero" per te.

Gatekeeping

"Il gatekeeping è quando qualcuno si assume la responsabilità di decidere chi ha o meno accesso o diritti a una comunità o identità." - Dizionario urbano

Il gatekeeping è una forma di elitarismo e va contro il nostro principio di accessibilità. Se vuoi capire meglio cos'è il gatekeeping, Reddit ha un subreddit dedicato ad esso con alcuni esempi tristi (e occasionalmente ironici).

Molte volte, gli scrittori non si rendono conto che stanno controllando. Ecco alcune espressioni che possono usare:

  • ovviamente
  • semplicemente [fai qualcosa]
  • certo [qualcosa è tale e tale]
  • come tutti sanno
  • come probabilmente hai sentito
  • [qualcosa] è facile
  • qualsiasi ["idiota", "stupido", "principiante", "script kiddie", ecc.] può [fare qualcosa]

Se vedi il gatekeeping, rimuovilo. La maggior parte di queste espressioni in realtà non aggiunge nulla all'articolo.

Discriminazione

Abbiamo un codice di condotta rigoroso che cerca di impedire alle persone di essere discriminate sulla base di "sesso, identità ed espressione di genere, età, orientamento sessuale, disabilità, aspetto fisico, corporatura, razza, origine nazionale o religione (o mancanza di ciò). "

Se vedi qualcosa che pensi rappresenti una discriminazione, rimuovila. Non tutte le culture prendono queste cose con lo stesso livello di serietà degli americani. Ma se pensi che non sia un malinteso e che lo scrittore sia intenzionalmente discriminatorio, ti preghiamo di portarlo alla mia attenzione.

Parolacce inutili

Siamo molto letti da un pubblico di tutte le età, quindi cerchiamo di non pubblicare affatto parolacce.

Parole blande parolacce come "accidenti" ed espressioni come "che diavolo" sono accettabili.

Nella maggior parte dei casi, esiste un'alternativa meno profana alle frasi profane che significano la stessa cosa e trasmettono emozioni simili.

A volte, ad esempio, la parola f è inclusa come aggettivo, il che è fondamentalmente non necessario. Le persone spesso usano la parola s come sinonimo di "cattivo", e questo può anche essere sostituito con qualcosa di meno profano. L'espressione "BS" significa fondamentalmente "falso" o "bugie".

Siamo una pubblicazione tecnica, quindi nella maggior parte dei casi la scrittura non sarà molto accesa. In caso di dubbio, puoi usare **** per sostituire parte della parola offensiva.

Processo di post-pubblicazione

Dopo aver pubblicato un articolo, contribuiamo a pubblicizzarlo su Twitter, Facebook e LinkedIn. Usiamo Buffer per programmare tutti questi post, in modo che vengano pubblicati nel miglior orario possibile.

Prima di pubblicizzare, eseguiamo gli articoli tramite il debugger di Facebook e il validatore di carte di Twitter. Se hanno un bell'aspetto e sono pronti, premiamo l'icona "tweet" nell'articolo pubblicato su Medium, copiamo il testo del tweet e carichiamo quel testo in Buffer.

Per i post di Twitter, rimuoviamo semplicemente le virgolette attorno al titolo dell'articolo e aggiungiamo una virgola dopo il titolo (se non ci sono altri segni di punteggiatura alla fine). Se Medium chiama l'autore tramite l'handle di Twitter, lasciamo "by @username" lì. Se usa solo il loro nome completo, cancelliamo la parte "per [nome] [cognome]" dal tweet.

Per i post di LinkedIn e Facebook, rimuoviamo le virgolette dal titolo ed eliminiamo il resto del testo, lasciando solo il titolo del post e il link.

Una volta che abbiamo bufferizzato questi post, consideriamo l'articolo finito.

Conclusione

Grazie per aver letto questa guida. Se hai suggerimenti su come migliorarlo, fammelo sapere. Si spera che questa guida cresca fino a includere considerazioni editoriali aggiuntive e casi limite comunemente riscontrati.

Questo è un esempio di piè di pagina per un articolo medio.

Grazie per aver letto. Se hai dei pensieri su questo, assicurati di lasciare un commento.

Se hai trovato utile questo articolo, dammi qualche applauso?

E puoi seguirmi su Twitter qui.