Comment se faire publier dans la publication Medium de freeCodeCamp

Article original : How to get published in the freeCodeCamp Medium publication

Mise à jour : Au lieu de publier sur Medium, nous utilisons désormais notre propre outil open-source auto-hébergé où nous publions des articles pour un public encore plus large.

Vous pouvez en savoir plus sur notre transition dans ce fil de forum, qui inclut des instructions pour postuler en tant qu'auteur, lire ce guide de style.

Ce qui suit est à des fins historiques si vous êtes curieux.

Notre communauté open source gère la plus grande publication technique de Medium. Si vous écrivez sur le développement, le design ou la science des données — et que vous cherchez un public — c'est un bon endroit pour vous faire publier.

Nos statistiques des 90 derniers jours. Elles sont suffisamment élevées pour casser le CSS sur l'axe Y des graphiques de Medium.

freeCodeCamp est une communauté open source avec des milliers de contributeurs, mentors, enseignants et organisateurs d'événements.

Plus d'un million de personnes apprennent à coder en utilisant freeCodeCamp chaque mois, et des milliers d'entre nous ont travaillé à travers le programme de 1 200 heures et obtenu leur premier emploi de développeur.

Nous sommes une organisation à but non lucratif. Vous pouvez nous aider à payer pour les serveurs et autres coûts en devenant un supporter.

Voici ce que tout cela signifie pour vous en tant qu'auteur :

Nous ne couvrirons pas votre histoire de publicités, ni ne la mettrons derrière un paywall (ou un "email wall" ou autre — pas de trucs bizarres).
Vous pouvez inclure des liens vers votre propre blog ou service, et même des liens d'affiliation, tant que cela est fait avec goût et transparence.
Vos histoires vous appartiennent. Nous ne revendiquons aucun droit sur elles. Vous pouvez les publier ailleurs si vous le souhaitez. D'autres journaux et sites web peuvent même vous approcher pour les syndiquer ou les traduire. Cela nous convient. Nous demandons simplement — puisque nous investissons beaucoup de temps dans l'édition et la promotion de vos histoires — que vous ne les retiriez pas de notre publication Medium une fois que nous les avons publiées.

Nos éditeurs ont de l'expérience dans la gestion de journaux et l'édition de publications techniques. Nous lirons votre soumission, et si nous pensons qu'elle est prometteuse, nous vous donnerons des commentaires francs sur la manière de l'améliorer. Ensuite, nous effectuerons l'édition finale de votre histoire, la publierons, puis vous aiderons à la promouvoir.

Depuis que nous avons lancé cette publication Medium il y a 18 mois :

nous avons publié environ 1 000 histoires
qui ont reçu en moyenne 23 000 vues
avec une médiane de 6 500 vues (c'est-à-dire que la moitié de ces histoires ont reçu au moins 6 500 vues)

Donc, si vous écrivez sur la technologie, nous pouvons vous aider à atteindre un public beaucoup plus large.

Table des matières

Comment nous évaluons, éditons et publions les histoires

Note : J'ai caché les instructions de soumission, le mot secret et l'adresse e-mail dans le texte ci-dessous pour que vous lisiez tout cela. ?

Nous recevons plus de 100 soumissions chaque semaine et nous sommes protecteurs du temps de nos lecteurs. Nous cherchons à ne publier que des histoires qui sont :

bien écrites
sur des sujets intéressants que les gens n'ont pas déjà trop écrits
pertinentes pour notre public de développeurs, designers et data scientists.

Si nous pensons que votre histoire est un bon choix, nous vous ajouterons en tant qu'auteur à la publication freeCodeCamp et vous enverrons une lettre d'acceptation avec des instructions supplémentaires.

Ensuite, nous mettrons votre histoire dans la file d'attente pour être éditée et publiée. (Voici notre manuel de l'éditeur si vous êtes curieux de ce processus). Ce processus peut prendre un certain temps, donc nous vous remercions à l'avance pour votre patience. Vous pourrez voir les modifications dans l'historique des révisions de Medium. Vous aurez toujours le contrôle total de votre article si vous devez faire des mises à jour.

Si nous ne pensons pas que votre histoire est un bon choix pour la publication freeCodeCamp, nous vous enverrons un e-mail pour vous le faire savoir. Pas de souci. Cela n'affectera pas négativement votre capacité à faire publier des histoires ultérieures ici.

Notez que tous nos éditeurs ont d'autres responsabilités au sein de la communauté open source, donc il peut falloir plusieurs jours pour que nous vous répondions. Mais tant que vous suivez les instructions de soumission cachées ci-dessous, nous vous répondrons.

Un guide rapide pour bien écrire sur Medium

En tant qu'auteur, vous livrez une bataille contre l'indifférence. Vous devez faire en sorte que les gens se soucient suffisamment de votre histoire pour cliquer dessus. Vous devez les convaincre de prendre une chance sur vous.

Vous n'avez que deux armes contre le défilement incessant des fils d'actualité : un titre et une image.

Voici à quoi ressemble une histoire dans le fil d'actualité de Medium :

Voici à quoi cela ressemble sur Facebook :

Et voici à quoi cela ressemble sur Twitter :

Votre titre et votre image d'ouverture sont les seules choses que les gens ont pour juger votre histoire. Avant même qu'ils puissent lire le premier paragraphe de votre histoire, ils doivent répondre à une question. C'est la même question que nous nous posons tous chaque jour : est-ce que cela va valoir mon temps ?

Votre premier travail en tant qu'auteur est de choisir un titre et une image qui feront que les gens répondront "oui".

Un bon titre fait toute la différence

Votre titre est la partie la plus importante de votre histoire. Prenez le temps de le peaufiner.

N'utilisez pas de clickbait : "Vous ne croirez pas ce modèle de titre ridiculement efficace"

N'utilisez pas de listicles : "11 titres outrageux qui obligeront les gens à lire votre histoire Medium"

Dites la vérité : "Titre intelligent mais factuel sur un sujet intéressant"

Combien de mots doit contenir votre titre ? HubSpot a analysé 6 000 articles de blog et a découvert que les histoires avec des titres de 8 à 14 mots obtiennent plus de partages sur les réseaux sociaux.

Cela dit, assurez-vous que votre titre ne dépasse pas 80 caractères. Sinon, le titre sera tronqué dans les fils d'actualité lorsque les gens partageront votre article sur Facebook et Twitter.

Un autre critère est le degré d'émotion d'un titre. Plus un titre est émotionnel (positif ou négatif), plus les gens sont susceptibles de cliquer dessus.

Voici un outil qui vous aide à équilibrer la longueur et le sentiment de vos titres.

Une capture d'écran de l'analyse de l'outil pour l'un de mes titres. Les résultats peuvent varier.

Les titres sont traditionnellement écrits en "title case". L'Associated Press dit de "mettre en majuscule la première lettre de chaque mot sauf les articles, les conjonctions de coordination et les prépositions de trois lettres ou moins".

Sur Medium, je jette souvent la title case par la fenêtre et j'écris simplement des titres comme une phrase normale. J'inclus même la ponctuation si nécessaire. Ce format est plus conversationnel et plus facile à lire.

Ne divisez pas les histoires en parties. Les étiquettes comme "partie 1" effraient les gens, car qui sait quand vous écriverez la partie 2. Et si les gens tombent sur la "partie 2" et qu'ils n'ont pas lu la partie 1, il y a de fortes chances qu'ils ne se donnent pas la peine de lire l'une ou l'autre. Il est donc beaucoup mieux de publier une seule histoire approfondie.

Captiver avec des images

Le deuxième aspect le plus important de votre histoire est son image principale.

Medium utilisera automatiquement la première image de votre article comme image principale. Cela signifie que la propriété meta og-image de votre article sera cette image. Cette image servira d'ambassadrice de votre histoire partout : fils d'actualité des réseaux sociaux, Reddit, Google News — même les lecteurs RSS.

Vous pouvez forcer manuellement Medium à traiter une image spécifique comme l'image principale de votre article. En mode édition, cliquez sur l'image, puis :

Mac : + Opt + 8
PC : Ctrl + Alt + 8

Commencez à réfléchir aux images tôt dans le processus d'écriture. Et ne publiez jamais sans au moins une image. Sinon, votre histoire sera presque invisible dans les fils d'actualité.

Vous devriez diviser les longues histoires avec des images. Pour paraphraser Mary Poppins, une cuillère à café d'images aide le texte à passer.

Medium offre quatre largeurs d'image différentes. Notez que celles-ci auront toutes la même apparence sur mobile.

La plupart du temps, vous voudrez rester avec la largeur de colonne :

Si vous avez un graphique difficile à lire lorsqu'il est petit, allez plus grand :

Et si vous êtes vraiment fier d'une image, ou si elle est remplie de données intéressantes, allez en plein écran :

… et puis il y a le format en bandoulière. Ne l'utilisez pas du tout, car il rend le texte moins confortable à lire.

C'est aussi gênant lorsque vous avez fini de parler de la photo et que votre texte est toujours poussé sur le côté.

Oui. Je suis toujours coincé ici.

Incluez toujours une image haute résolution en haut d'une histoire sous votre titre. Cela présente les avantages suivants :

Lorsque les gens partagent votre histoire sur Facebook et Twitter, elle sera plus visible dans les fils d'actualité, ce qui rendra les gens plus susceptibles de cliquer dessus.
Elle aura meilleure allure dans les propres fils d'actualité de Medium.
Les humains sont des créatures visuelles et cliquent sur les images.

Créer de l'élan avec une introduction forte

Une fois que votre lecteur a cliqué sur votre histoire, l'épreuve commence. Il cherche la moindre excuse pour retourner à son fil d'actualité. Lire demande beaucoup plus d'efforts que de faire défiler des photos de chats.

Ne perdez pas de temps avec des introductions ou des mises à jour comme "Ceci a été publié sur mon blog à [URL du blog]" ou "Mise à jour : ceci a été posté sur Hacker News". Vous pouvez mettre ces choses à la fin de votre histoire.

Au lieu de cela, commencez à faire des points et à raconter votre histoire immédiatement.

Établir la crédibilité

Trouvez un moyen d'établir votre crédibilité dans les premiers paragraphes. Si vous êtes un expert de premier plan dans votre domaine, dites-le. Ne supposez pas que les gens prendront le temps de vous googler.

"Qui vous êtes parle si fort que je ne peux pas entendre ce que vous dites." — Ralph Waldo Emerson

Toute réalisation ou distinction qui fait que les gens vous prennent plus au sérieux aidera à donner à vos lecteurs l'impression que "cette personne sait de quoi elle parle".

Renforcez votre crédibilité tout au long de votre histoire. Soutenez vos arguments avec des données. Utilisez des liens en ligne vers des recherches (non payantes).

Ce n'est pas le New England Journal of Medicine. C'est Medium. Donc, n'utilisez pas de notes de bas de page.

Écrire intelligemment

Bien écrire est difficile. Comme toute compétence, cela demande de la pratique. Il n'y a pas de raccourcis pour devenir un bon écrivain.

Rendez-vous service : écrivez ce que vous connaissez.

Avez-vous déjà entendu le terme "syndrome de la page blanche" ? Le syndrome de la page blanche survient lorsque vous ne connaissez pas assez un sujet pour en écrire.

Si vous avez du mal à trouver au moins cinq minutes de choses à dire sur un sujet — ou si votre histoire se transforme en une liste de points — vous ne le connaissez pas assez.

Le remède est la recherche. L'apprentissage. Aller sur le terrain.

Ne publiez rien dont vous n'êtes pas fier. Medium n'est pas un jeu de chiffres. C'est un contrat social. Les gens vous suivent. En retour, vous montrez du respect pour leur temps précieux.

Les bonnes histoires Medium ne viennent pas naturellement. Pour chaque minute de longueur d'histoire, prévoyez de passer au moins une heure à écrire, réécrire et éditer votre histoire.

Attribuer vos sources

La manière la plus simple d'attribuer une image est de mettre les mots "Crédit image" sous une image, et de lier ce texte à sa source originale.

Si vous cherchez des images que vous pouvez utiliser sans permission, consultez Pexels, Unsplash, ou recherchez sur Google des images étiquetées pour réutilisation.

Une requête de recherche d'image Google avec l'option "Étiquetées pour réutilisation" sélectionnée.

Le plagiat — présenter l'écriture de quelqu'un d'autre comme la vôtre — est une infraction grave à l'université, et c'est tout aussi grave sur Medium. Attribuez toujours les citations aux personnes qui les ont originally dites. Si c'est une citation de plusieurs lignes, vous devriez utiliser les citations en exergue de Medium :

"Quand on a de l'esprit, c'est un plaisir de créditer les autres pour le leur." — Criss Jami

Vous ne devriez utiliser les citations en exergue de Medium que pour mettre en valeur des citations réelles — et non pour styliser votre propre texte.

Mettre en valeur votre code

Là où c'est possible, le code doit être sous forme de texte plutôt que d'images. Cela rend le code plus accessible aux lecteurs d'écran, et plus facile à copier et coller.

Medium a un raccourci caché qui transformera du texte brut comme ceci :

if (developer === true) {

follow(this.mediumPublication);

}

…en un bloc de code formaté :

if (developer === true) {

  follow(this.mediumPublication);

Pour ce faire, sélectionnez le texte, puis appuyez sur :

Windows : Control + Alt + 6
Mac : Command + Option + 6
Linux : Control + Alt + 6

Vous pouvez également commencer un bloc de code avec trois backticks. Si vous tapez trois backticks (```) sur une nouvelle ligne, Medium passera en mode de saisie de code.

Pour mettre en évidence du code en ligne, sélectionnez-le, puis appuyez sur la touche backtick. Ainsi, vous pouvez formater du texte en code freeCodeCamp() directement au milieu d'une phrase.

Vous pouvez même intégrer des applications exécutables directement dans Medium. Au cas où celles-ci ne s'afficheraient pas correctement dans les applications mobiles de Medium, je recommande d'inclure des liens sous chaque intégration comme solution de repli.

Collez une URL CodePen.io dans Medium, puis appuyez sur Entrée :

View my CodePen here.

Vous pouvez également le faire avec JSFiddle.net :

View my JSFiddle here.

Parfois, les gens commencent les lignes de code par un $ si ce sont des commandes de terminal. Ne faites pas cela. Cela confusera les débutants et rendra plus difficile la copie et le collage des commandes. Au lieu de cela, dites simplement quelque chose comme "Entrez les commandes suivantes dans votre terminal."

Rendre les liens naturels

Trouvez un moyen d'intégrer un lien dans une phrase. Une chose que je ne recommande pas de faire est de mettre un lien sur sa propre ligne et d'appuyer sur Entrée. Cela créera une belle carte de prévisualisation, comme ceci :

Comment se tenir sur les épaules des géants _Conquer Not Invented Here Syndrome, then do something new._medium.freecodecamp.com

… mais les lecteurs supposent souvent que ce sont des publicités et ne les regardent même pas.

La seule fois où je recommanderais d'utiliser cela est à la fin de votre histoire, si vous voulez lier à des lectures supplémentaires.

Souligner le texte le rend plus difficile à lire, donc ne mettez en hyperlien que quelques mots.

Ne collez pas les URL directement, comme ceci : https://www.freecodecamp.com

Au lieu de cela, liez les sites comme freeCodeCamp au milieu de la phrase, comme je viens de le faire ici.

Intégrer des médias

Vous pouvez intégrer des Tweets, des vidéos YouTube et d'autres médias en collant leurs URL dans Medium sur une nouvelle ligne, puis en appuyant sur Entrée.

Utilisez-les avec parcimonie, car ils peuvent distraire votre lecteur de la fin de votre histoire.

Expliquer les abréviations

N'utilisez pas une abréviation à moins que l'abréviation ne soit plus largement comprise que ce qu'elle représente. Par exemple, HTTP est plus largement reconnu que Hypertext Transfer Protocol.

Si une abréviation n'est pas déjà largement comprise, et que vous allez vous y référer plus de quelques fois, vous pouvez la définir comme une abréviation en faisant ceci :

"Décomposons le code en un Abstract Syntax Tree (AST)."

Ici, j'ai également lié l'article Wikipedia, pour la commodité des lecteurs. Ne supposez pas que les gens liront ces liens externes, cependant. Vous devez toujours définir les concepts ou les illustrer par des exemples.

Évitez de définir une abréviation dans vos paragraphes d'ouverture, car cela ralentit votre lecteur et le rend moins susceptible de continuer à lire.

Voici la très courte liste des abréviations technologiques que vous n'avez pas besoin de définir : API, AJAX, BIOS, CPU, CSS, HTML, HTTPS, JSON, LAN, RAM, REST, USB, WWW, XML. Pour tout le reste, vous devez l'écrire en toutes lettres.

Écrivez toujours en toutes lettres les mots courts en plusieurs parties comme JavaScript et front-end. Ne les raccourcissez pas. La brièveté n'en vaut pas la confusion possible.

Apparence et style

Si vous voulez mettre l'accent sur quelque chose, utilisez gras, mais utilisez-le avec parcimonie. L'italique est plus difficile à lire. Ne mettez pas en gras les hyperliens — la ligne sous eux fournit déjà suffisamment d'emphase.

N'utilisez pas de lettrines. Elles ont l'air élégantes dans les vieux livres, mais ridicules sur le web.

Quelques lettrines imprimées à l'ancienne

N'utilisez qu'un seul point d'exclamation à la fois, généralement seulement après des exclamations comme : Golly gee ! Hot dog !

Mettez les virgules et les points à l'intérieur des guillemets, sauf lorsque cela pourrait confondre un lecteur (comme avec les noms de variables ou les titres de livres).

Dans certaines parties du monde, les gens mettent des espaces avant les deux-points ou les points d'interrogation, comme ceci : exemple. Ne faites pas cela.

Utilisez l'anglais au lieu du latin :

Utilisez "par exemple" au lieu de "E.G."
Utilisez "c'est-à-dire" au lieu de "I.E."
Utilisez "notez que" au lieu de "N.B."
Au lieu de terminer les listes avec "etc.", commencez-les avec "comme" : "Elvis mange des aliments comme du pain, du beurre de cacahuète et des bananes."

Selon Google Books, les points-virgules sont en train de mourir d'une mort lente. Mettons-les hors de leur misère. Utilisez simplement un point à la place, et divisez les clauses en phrases séparées.

Utilisez la virgule d'Oxford lorsque c'est possible. Cela rend les choses plus faciles, plus claires et plus jolies à lire.

Utilisez l'application Hemingway. Il n'y a rien de magique dans cet outil simple, mais il détectera automatiquement les problèmes de style largement admis :

voix passive
adverbes inutiles
mots qui ont des équivalents plus courants

L'application Hemingway attribuera un "niveau de classe" à votre écriture. Même les histoires techniques peuvent obtenir un niveau de classe de 6. Et elles devraient aspirer à cela.

La plupart des humains ne sont pas des locuteurs natifs de l'anglais, et ceux qui le sont ne passent pas généralement leur journée à lire Chaucer. Ils veulent que leur information soit accessible et directe.

Préférez diviser les longues phrases et paragraphes en phrases et paragraphes plus courts.

Contrairement à ce que vous avez peut-être appris en cours de composition anglaise, les gens préfèrent les paragraphes courts aux "murs de texte".

Il n'y a rien de mal avec les paragraphes d'une seule phrase.

Préférez créer de nouveaux paragraphes.

Utilisez des contractions. Elles rendront votre prose plus conversationnelle. C'est toujours un plus.

Gardez votre temps cohérent tout au long. Si vous parlez de quelque chose qui s'est produit dans le passé, utilisez le passé.

De plus, le développement front-end (forme adjectivale avec un trait d'union) est lorsque vous travaillez sur le front end (forme nominale sans trait d'union). Il en va de même pour le back end, full stack, et de nombreux autres termes composés.

Ajouter 5 tags

Medium vous permet d'ajouter jusqu'à cinq tags à votre histoire. Utilisez-les.

Les gens suivent des sujets spécifiques sur Medium. Les plus populaires sont #tech, #life-lessons, #travel, #design, et #startup.

Les personnes qui suivent les tags que vous utilisez peuvent voir votre histoire dans leur fil d'actualité. Les tags rendent également plus facile pour les gens de tomber sur votre histoire dans les résultats de recherche.

Et maintenant que vous avez lu jusqu'ici, voici comment soumettre votre histoire à la publication freeCodeCamp : envoyez un e-mail à submit at freecodecamp org. Incluez l'URL de votre histoire sur Medium (de préférence un brouillon non publié) et le mot "bananas" pour que nous sachions que vous avez tout lu. N'envoyez qu'une seule URL d'histoire par e-mail. Il n'est pas nécessaire d'ajouter quoi que ce soit de plus à votre e-mail — nous lisons simplement les histoires et les jugeons sur leurs propres mérites.

Promouvoir vos histoires sur les réseaux sociaux

Vous pouvez partager votre histoire sur Twitter, les groupes Facebook et les Subreddits pertinents. Si vous avez une liste de diffusion, vous pouvez l'envoyer à vos abonnés également.

Vous pouvez consulter les statistiques de votre histoire en temps réel. Demandez des commentaires à vos amis et followers. Incorporez ces commentaires dans votre histoire.

Ne faites rien de louche pour promouvoir votre histoire. Vous serez très probablement attrapé. Des sites comme Hacker News et Reddit sont très bons pour détecter les comportements de vote anormaux. Cela reflétera mal non seulement sur vous, mais aussi sur toute la communauté freeCodeCamp.

Conseils finaux

Rappelez-vous que lorsque vous publiez sur Medium, vous demandez à des milliers de personnes de vous accorder plusieurs minutes de leur vie. Ne prenez pas vos lecteurs pour acquis.

Avant de publier une histoire, je vous recommande de dormir, de vous réveiller, puis de la relire.

Si vous n'êtes pas un locuteur natif de l'anglais et que vous écrivez en anglais, demandez à un locuteur natif de relire votre histoire avant de la soumettre à une publication.

Nous avons hâte de lire vos soumissions. J'espère que nous pourrons vous aider à améliorer davantage vos histoires et à atteindre un public beaucoup plus large.