Cómo ser publicado en la publicación FreeCodeCamp Medium

Actualización: en lugar de publicar en Medium, ahora ejecutamos nuestra propia herramienta de código abierto autohospedada en la que publicamos artículos para una audiencia aún mayor.

Puede leer más sobre nuestro movimiento en este hilo del foro, que incluye instrucciones sobre cómo puede postularse para convertirse en autor, lea esta guía de estilo.

Lo que sigue es para propósitos históricos si tiene curiosidad.

Nuestra comunidad de código abierto ejecuta la publicación técnica más grande de Medium. Si escribe sobre desarrollo, diseño o ciencia de datos, y está buscando una audiencia, este es un buen lugar para publicar.

freeCodeCamp es una comunidad de código abierto con miles de colaboradores, mentores, profesores y organizadores de eventos.

Más de un millón de personas aprenden a codificar usando freeCodeCamp cada mes, y miles de nosotros hemos trabajado en el plan de estudios de 1200 horas y obtuvimos sus primeros trabajos de desarrollador.

Somos una organización sin fines de lucro. Puede ayudarnos a pagar los servidores y otros costos convirtiéndose en colaborador.

Esto es lo que significa todo esto para ti como escritor:

  • No cubriremos su historia con anuncios, ni la pondremos detrás de un muro de pago (o "muro de correo electrónico" o cualquier cosa, sin trucos extraños).
  • Puede incluir enlaces a su propio blog o servicio, e incluso enlaces de afiliados, siempre que se haga de forma transparente y con buen gusto.
  • Tus historias son tuyas. No les hacemos ningún reclamo. Puedes publicarlos de forma cruzada donde quieras. Es posible que otros periódicos y sitios web incluso se le acerquen para distribuirlos o traducirlos. Eso está bien para nosotros. Solo te pedimos que, dado que invertimos mucho tiempo en editar y promover tus historias, no las elimines de nuestra publicación en Medium una vez que las hayamos publicado.

Nuestros editores tienen experiencia en la ejecución de periódicos y la edición de publicaciones técnicas. Leeremos su envío y, si creemos que es prometedor, le daremos comentarios sinceros sobre cómo puede mejorarlo. Luego, realizaremos la edición final de su historia, la publicaremos y luego lo ayudaremos a publicitarla.

Desde que lanzamos esta publicación de Medium hace 18 meses:

  • hemos publicado alrededor de 1,000 historias
  • que han recibido una media de 23.000 visualizaciones
  • con una mediana de 6.500 visitas (es decir, la mitad de estas historias han recibido al menos 6.500 visitas)

Entonces, si escribe sobre tecnología, podemos ayudarlo a llegar a una audiencia mucho más amplia.

Tabla de contenido

  • Cómo evaluamos, editamos y publicamos historias
  • Una introducción rápida para escribir bien en medio
  • Un buen titular marca la diferencia
  • Arresto con imágenes
  • Genere impulso con una ventaja sólida
  • Establecer la credibilidad
  • Escribe inteligentemente
  • Atribuye tus fuentes
  • Muestre su código
  • Haz que los enlaces parezcan naturales
  • Insertar medios
  • Explica las abreviaturas
  • Look y estilo
  • Agregar 5 etiquetas
  • Publique sus historias en las redes sociales
  • Consejo final

Cómo evaluamos, editamos y publicamos historias

Nota: He ocultado las instrucciones de envío, la palabra secreta y la dirección de correo electrónico en el texto a continuación para que pueda leer todo esto. ?

Recibimos más de 100 presentaciones cada semana y protegemos el tiempo de nuestros lectores. Buscamos publicar solo historias que sean:

  • bien escrito
  • sobre temas interesantes sobre los que la gente aún no ha escrito demasiado
  • relevante para nuestra audiencia de desarrolladores , diseñadores y científicos de datos .

Si creemos que su historia encaja bien, lo agregaremos como escritor a la publicación freeCodeCamp y le enviaremos una carta de aceptación con más instrucciones.

Luego pondremos tu historia en la cola para ser editada y publicada. (Aquí está nuestro manual del editor si tiene curiosidad sobre este proceso). Este proceso puede tardar un poco, por lo que le agradecemos de antemano su paciencia. Podrás ver las ediciones en el historial de revisiones de Medium. Aún tendrá el control total de su artículo si necesita realizar actualizaciones.

Si no creemos que su historia se ajuste bien a la publicación de freeCodeCamp, le enviaremos un correo electrónico informándole esto. Sin preocupaciones. No afectará negativamente su capacidad para publicar historias posteriores aquí.

Tenga en cuenta que todos nuestros editores tienen otras responsabilidades dentro de la comunidad de código abierto, por lo que es posible que nos lleve varios días responderle. Pero siempre que siga las instrucciones de envío que se esconden a continuación, le responderemos.

Una introducción rápida para escribir bien en medio

Como escritor, luchas una guerra contra la indiferencia. Tienes que conseguir que la gente se preocupe lo suficiente como para hacer clic en tu historia. Tienes que convencerlos de que se arriesguen contigo.

Solo tienes dos armas contra el incesante despliegue de noticias: un titular y una imagen.

Así es como se ve una historia en el servicio de noticias de Medium:

Así es como se ve en Facebook:

Y así es como se ve en Twitter:

El titular y la imagen de apertura son las únicas cosas que la gente tiene para juzgar tu historia. Antes de que puedan leer el primer párrafo de su historia, deben responder una pregunta. Es la misma pregunta que todos nos hacemos todos los días: ¿va a valer la pena mi tiempo?

Su primer trabajo como escritor es elegir un titular y una imagen que haga que la gente responda "sí".

Un buen titular marca la diferencia

Tu titular es la parte más importante de tu historia. Dedique tiempo a refinarlo.

No utilice clickbait: "No creerá este patrón oscuro de título ridículamente efectivo"

No utilices listas: "11 titulares escandalosos que obligarán a la gente a leer tu historia de Medium"

Diga la verdad: "Título inteligente pero práctico sobre un tema interesante"

¿Qué tan largo debería ser tu titular? HubSpot analizó 6.000 publicaciones de blogs y descubrió que las historias con titulares de 8 a 14 palabras se comparten más en las redes sociales.

Dicho esto, asegúrese de que su título tenga 80 caracteres o menos . De lo contrario, el título se truncará en las fuentes de noticias cuando las personas compartan su artículo en Facebook y Twitter.

Otra consideración es qué tan emotivo es un titular. Cuanto más emocional (positivo o negativo) sea un titular, es más probable que la gente haga clic en él.

Aquí tienes una herramienta que te ayuda a equilibrar la duración y el sentimiento de tus titulares.

Los titulares se escriben tradicionalmente en "mayúsculas y minúsculas". Associated Press dice que "ponga en mayúscula la primera letra de cada palabra, excepto los artículos, las conjunciones coordinadas y las preposiciones de tres letras o menos".

En Medium, a menudo arrojo el título por la ventana y solo escribo titulares como una oración normal. Incluso incluyo puntuación según sea necesario. Este formato es más conversacional y más fácil de leer.

No divida las historias en partes. Las etiquetas como "parte 1" asustan a la gente, porque quién sabe cuándo llegarás a escribir la parte 2. Y si las personas se encuentran con la "parte 2" y no han leído la parte 1, es muy probable que no lo hagan. molestarse en leer tampoco. Así que es mucho mejor publicar una sola historia en profundidad.

Arresto con imágenes

El segundo aspecto más importante de su historia es su imagen destacada.

Medium convertirá automáticamente la primera imagen de tu artículo en su imagen destacada. Esto significa que la metapropiedad og-image de su artículo será esta imagen. Esta imagen servirá como embajadora de su historia en todas partes: fuentes de noticias de redes sociales, Reddit, Google News, incluso lectores de RSS.

Puede forzar manualmente a Medium a tratar una imagen específica como la imagen destacada de su artículo. En el modo de edición, haga clic en la imagen y luego:

  • Mac: ⌘ + Opc + 8
  • PC: Ctrl + Alt + 8

Empiece a considerar las imágenes al principio del proceso de escritura. Y nunca publiques sin al menos una imagen. De lo contrario, su historia será casi invisible en las noticias.

Deberías dividir las historias largas con imágenes. Parafraseando a Mary Poppins, una cucharada de imágenes ayuda a que el texto se transmita.

Medium ofrece cuatro anchos de imagen diferentes. Tenga en cuenta que todos tendrán el mismo aspecto en el móvil.

La mayoría de las veces, querrá ceñirse al ancho de columna:

Si tiene una tabla que es difícil de leer cuando es pequeña, amplíela:

Y si está realmente orgulloso de una imagen, o si está repleta de datos interesantes, hágalo a sangre:

... y luego está el lado a horcajadas. No use este tamaño en absoluto, porque hace que el texto sea menos cómodo de leer.

También es incómodo cuando terminas de hablar sobre la foto y tu texto todavía está a un lado.

Si. Todavía estoy atrapado aquí.

Incluya siempre una imagen de alta resolución en la parte superior de una historia debajo de su título. Esto tiene los siguientes beneficios:

  1. Cuando las personas comparten su historia en Facebook y Twitter, será más prominente en las fuentes de noticias, lo que aumentará la probabilidad de que la gente haga clic en ella.
  2. Se verá mejor en las propias fuentes de noticias de Medium.
  3. Los humanos son criaturas visuales y haga clic en las imágenes.

Genere impulso con una ventaja sólida

Una vez que su lector haga clic en su historia, comienza la prueba. Están buscando cualquier excusa para volver a sus noticias. Leer requiere mucho más esfuerzo que desplazarse por las fotos de gatos.

No pierda el tiempo con introducciones o actualizaciones como "Esto se publicó en mi blog en [URL del blog]" o "Actualización: esto se ha publicado en Hacker News". Puedes poner estas cosas al final de tu historia.

En su lugar, comience a señalar puntos y a contar su historia de inmediato.

Establecer la credibilidad

Encuentre una manera de establecer su credibilidad dentro de los primeros párrafos. Si es un experto superior en su campo, dígalo. No asuma que la gente se tomará el tiempo para buscarlo en Google.

"Quien eres habla tan alto que no puedo escuchar lo que estás diciendo". - Ralph Waldo Emerson

Cualquier logro o distinción que haga que las personas te tomen más en serio ayudará a que tus lectores tengan la impresión de que "esta persona sabe de lo que están hablando".

Refuerce su credibilidad a lo largo de su historia. Apoye sus argumentos con datos. Utilice enlaces en línea para la investigación (sin muro de pago).

Este no es el New England Journal of Medicine. Esto es medio. Así que no uses notas a pie de página.

Escribe inteligentemente

La buena escritura es difícil. Como cualquier habilidad, requiere práctica. No hay atajos para convertirse en un escritor fuerte.

Hazte un favor: escribe lo que sabes .

¿Alguna vez has escuchado el término "bloqueo de escritores"? El bloqueo del escritor ocurre cuando no sabes lo suficiente sobre un tema para escribir sobre él.

Si tiene problemas para encontrar al menos 5 minutos de cosas que decir sobre un tema, o si su historia se convierte en una lista de viñetas, no sabe lo suficiente al respecto.

El antídoto es la investigación. Aprendizaje. Salir al campo.

No publique nada de lo que no esté orgulloso. Medium no es un juego de números. Es un contrato social. La gente te sigue. A su vez, muestras respeto por su escaso tiempo.

Las buenas historias de Medium no surgen de forma natural. Por cada minuto de duración de la historia, espere pasar al menos una hora escribiendo, reescribiendo y editando su historia.

Atribuye tus fuentes

La forma más sencilla de atribuir una imagen es poner las palabras "Crédito de la imagen" debajo de una imagen y vincular este texto a su fuente original.

Si está buscando imágenes que pueda usar de forma segura sin permiso, consulte Pexels, Unsplash o busque en Google imágenes etiquetadas para su reutilización.

El plagio (tergiversar los escritos de otra persona como propios) es un delito grave en la universidad y es igualmente grave en Medium. Siempre atribuya las citas a las personas que las dijeron originalmente. Si se trata de una cita de varias líneas, debe utilizar las citas extraídas de Medium:

"Cuando tienes tu propio ingenio, es un placer dar crédito a otras personas por el suyo".

- Criss Jami

Solo debe usar las citas extraídas de Medium como una forma de resaltar las citas reales, no para diseñar su propio texto.

Muestre su código

Siempre que sea posible, el código debe estar en forma de texto en lugar de imágenes. Esto hace que el código sea más accesible para los lectores de pantalla y más fácil de copiar y pegar para las personas.

Medium tiene un atajo oculto que convertirá el texto en texto sin formato como este:

if (desarrollador === verdadero) {

seguir (this.mediumPublication);

}

... en un bloque de código formateado:

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

Para lograr esto, seleccione el texto, luego presione:

  • Windows : Control + Alt + 6
  • Mac : Comando + Opción + 6
  • Linux : Control + Alt + 6

También puede iniciar un bloque de código con tres retrocesos. Si escribe tres comillas invertidas (`` `) en una nueva línea, Medium cambiará al modo de entrada de código.

Para resaltar el código en línea, selecciónelo y luego presione la tecla de tilde. De esta manera, puede formatear el texto como código freeCodeCamp()justo en medio de una oración.

Incluso puede incrustar aplicaciones ejecutables directamente en Medium. En caso de que no se muestren correctamente en las aplicaciones móviles de Medium, recomiendo incluir enlaces debajo de cada una de las incrustaciones como respaldo.

Pegue una URL de CodePen.io en Medio, luego presione enter:

Vea mi CodePen aquí.

También puede hacer esto con JSFiddle.net:

Vea mi JSFiddle aquí.

A veces, las personas comienzan las líneas de código con un $si son comandos de terminal. No hagas esto. Confundirá a los principiantes y hará más difícil copiar y pegar comandos. En su lugar, solo di algo como "Ingresa los siguientes comandos en tu terminal".

Haz que los enlaces parezcan naturales

Encuentra una manera de convertir un enlace en una oración. Una cosa que no recomiendo hacer es poner un enlace en su propia línea y presionar enter. Esto creará una bonita tarjeta de vista previa, como esta:

Cómo pararse sobre los hombros de gigantes.

Conquista el síndrome no inventado aquí, luego haz algo nuevo. medium.freecodecamp.com

… Pero los lectores a menudo asumen que se trata de anuncios y ni siquiera los miran.

La única vez que recomendaría usar esto es al final de su historia, si desea vincularlo a más lecturas.

Subrayar el texto hace que sea más difícil de leer, por lo tanto, solo haga hipervínculos con algunas palabras.

No pegue las URL directamente, como esta: ❌ //www.freecodecamp.com ❌

En su lugar, enlace a sitios como freeCodeCamp a mitad de oración, como acabo de hacer aquí.

Insertar medios

Puede incrustar Tweets, videos de YouTube y otros medios pegando sus URL en Medio en una nueva línea y luego presionando Intro.

Úselos con moderación, ya que pueden distraer a su lector de terminar su historia.

Explica las abreviaturas

No utilice una abreviatura a menos que la abreviatura se entienda más ampliamente de lo que significa. Por ejemplo, HTTP es más reconocido que el Protocolo de transferencia de hipertexto.

Si una abreviatura aún no se comprende ampliamente y va a hacer referencia a ella más de unas pocas veces, puede definirla como abreviatura haciendo esto:

"Dividamos el código en un árbol de sintaxis abstracta (AST)".

Aquí también me vinculé al artículo de Wikipedia, para comodidad de los lectores. Sin embargo, no asuma que la gente leerá estos enlaces externos. Aún necesita definir conceptos o ilustrarlos con ejemplos.

Evite definir una abreviatura en los párrafos iniciales, ya que ralentiza a su lector y hace que sea menos probable que continúe leyendo.

Aquí está la lista muy corta de abreviaturas de tecnología que no necesita definir: API, AJAX, BIOS, CPU, CSS, HTML, HTTPS, JSON, LAN, RAM, REST, USB, WWW, XML. Para todo lo demás, debes deletrearlo.

Deletree siempre palabras cortas de varias partes como JavaScript y front-end. No los acorte. La brevedad no merece la posible confusión.

Look y estilo

Si desea enfatizar algo, use negrita , pero úselo con moderación . Las cursivas son más difíciles de leer. No utilices hipervínculos en negrita: la línea debajo de ellos ya proporciona suficiente énfasis.

No use mayúsculas. Se ven elegantes en los libros antiguos, pero tontos en la web.

Use solo un signo de exclamación a la vez, generalmente solo después de exclamaciones como: ¡Caramba! ¡Pancho!

Coloque comas y puntos entre comillas, excepto cuando pueda confundir al lector (como con nombres de variables o títulos de libros).

En algunas partes del mundo, la gente pone espacios antes de dos puntos o signos de interrogación, así: ejemplo. No hagas esto.

Use inglés en lugar de latín:

  • Utilice "por ejemplo" en lugar de "EG"
  • Utilice "eso es" en lugar de "IE"
  • Utilice "tenga en cuenta" en lugar de "NB"
  • En lugar de terminar las listas con "etc." comience con "me gusta": "Elvis come alimentos como pan, mantequilla de maní y plátanos".

Según Google Books, los puntos y comas han estado muriendo lentamente. Saquémoslos de su miseria. En su lugar, use un punto y divida las cláusulas en oraciones separadas.

Utilice la coma de Oxford cuando sea posible. Hace las cosas más fáciles, claras y bonitas de leer.

Utilice la aplicación Hemingway. No hay nada mágico en esta sencilla herramienta, pero detectará automáticamente problemas de estilo ampliamente aceptados:

  • voz pasiva
  • adverbios innecesarios
  • palabras que tienen equivalentes más comunes

La aplicación Hemingway asignará un "nivel de grado" para su escritura. Incluso las historias técnicas pueden alcanzar un nivel de grado 6. Y deberían aspirar a hacerlo.

La mayoría de los seres humanos no son hablantes nativos de inglés, y los que lo son no suelen sentarse a leer Chaucer todo el día. Quieren que su información sea accesible y al grano.

Peca de dividir oraciones largas y párrafos en frases más cortas.

A pesar de lo que hayas aprendido en la clase de composición de inglés, la gente prefiere párrafos cortos a "paredes de texto".

No hay nada de malo en los párrafos de una sola oración.

Errar por el lado de la creación de nuevos párrafos.

Usa contracciones. Harán que tu prosa parezca más conversacional. Eso es siempre una ventaja.

Mantenga su tensión constante en todo momento. Si está hablando de algo que ocurrió en el pasado, use el tiempo pasado.

Además, el desarrollo de front-end (forma de adjetivo con un guión) es cuando estás trabajando en el front-end (forma de sustantivo sin guión). Lo mismo ocurre con el back-end, la pila completa y muchos otros términos compuestos.

Agregar 5 etiquetas

Medium te permite agregar hasta cinco etiquetas a tu historia. Usalos, usalos a ellos.

La gente sigue temas específicos en Medium. Los más populares son # tecnología, # lecciones de vida, # viajes, # diseño y # inicio.

Las personas que siguen las etiquetas que usa pueden ver su historia en sus noticias. Las etiquetas también facilitan que las personas encuentren tu historia en los resultados de búsqueda.

Y ahora que ha leído hasta aquí, aquí le mostramos cómo enviar su historia a la publicación freeCodeCamp: envíe un correo electrónico para enviarlo a freecodecamp org. Incluya la URL de su historia en Medium (preferiblemente un borrador inédito) y la palabra "bananas" para que sepamos que ha leído todo esto. Envíe solo una URL de historia por correo electrónico. No es necesario que agregue nada más a su correo electrónico, solo leemos las historias y las juzgamos según sus propios méritos.

Publique sus historias en las redes sociales

Puede compartir su historia en Twitter, grupos de Facebook y subreddits relevantes. Si tiene una lista de correo, también puede distribuirla a sus suscriptores.

Puede ver las estadísticas de su historia en tiempo real. Pide comentarios a tus amigos y seguidores. Incorpora esta retroalimentación en tu historia.

No hagas nada superficial para promover tu historia. Lo más probable es que lo atrapen. Sitios como Hacker News y Reddit son muy buenos para detectar comportamientos de votación anormales. Esto se reflejará mal no solo en usted, sino también en toda la comunidad de freeCodeCamp.

Consejo final

Recuerda que cuando publicas en Medium, estás pidiendo a miles de personas que te den varios minutos de sus vidas. No dé por sentado a sus lectores.

Antes de publicar una historia, le recomiendo que se duerma, se despierte y vuelva a revisarla.

Si no es un hablante nativo de inglés y está escribiendo en inglés, pídale a un hablante nativo que revise su historia antes de enviarla a una publicación.

Esperamos leer sus envíos. Espero que podamos ayudarlo a mejorar aún más sus historias y llegar a una audiencia mucho más amplia.