Skip to content

Instantly share code, notes, and snippets.

@mariochavez
Created January 10, 2020 19:01
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save mariochavez/f627bc379f3d165a0d13ee372dbfecf9 to your computer and use it in GitHub Desktop.
Save mariochavez/f627bc379f3d165a0d13ee372dbfecf9 to your computer and use it in GitHub Desktop.
Cómo hacer un post

Cómo hacer un post

Escribir un post técnico puede ser una tarea compleja por diferentes razones. Primeramente está el que quizás no estemos acostumbrados a escribir en general y puede haber un poco de resistencia a hacerlo.

Cuando ya estamos convencidos de escribir, la primer pregunta es "Qué escribir?". Es muy sencillo pensar que ya todo está escrito, que no hay nada nuevo a aportar, que quizás nuestro nivel técnico no es bueno para escribir un post para otras personas.

Las dudas son válidas, pero no realistas. Si bien es posible que el tema que queremos tratar ya está escrito en múltiples posts siempre es importante e interesante el revivir un tema desde nuestro punto de vista o nuestra óptica. El nivel técnico no es tan relevante, ya que el tema o la forma de llevarlo puede ser para el nivel que tenemos o bien puede ser para ayudar a otras personas que van comenzando.

El "Qué escribir?" solamente lo podemos atacar de una manera, escribir sobre algo que nos interesa o algo en lo que trabajamos y de lo que nos sentimos orgullosos; siempre va a ser más sencillo comenzar por estos puntos a tratar de escribir de algo que no hay una conexión directa.

En lo personal utilizo notion.so dónde siempre mantengo una lista de temas que me interesan, realizo apuntes y colecciono links los cuales puede que se conviertan en un post a futuro.

Por qué escribir?

El escribir un post sobre nuestro trabajo es una manera de poder constatar nosotros mismos que tenemos conocimiento del tema. También es una forma de nuestros compañeros de trabajo se enteren de lo que hacemos en nuestros proyectos.

Legalmente no me permite mencionar mi proyecto

Es posible que algunas de las cosas en las que trabajamos no las podemos divulgar tal cuál o ni siquiera mencionar al cliente con el cuál hicimos el trabajo que queremos documentar en el post.

Creo que la forma más simple de darle la vuelta a esta restricción es tratar de generalizar el problema que remos documentar y quizás extraer y reducir el problema a algo más sencillo que de alguna forma ejemplifique el tema de nuestro post.

No puedo escribir mi post de una sola vez

Hay gente que puede enfocarse al 100% y sentarse a escribir un post de una sola vez y en un par de horas. Ha otras personas que no podemos hacer eso.

Para el segundo caso podemos iniciar con los puntos que queremos cubrir en el posts, si es necesario consultar fuentes o hacer referencia a documentación u otros posts y mantener esa lista de referencias.

Al post quizás le podemos dedicar una hora o algo asá, escribir hasta dónde nos llegue la inspiración, sin esperar que la primera versión sea la final. Quizás el post necesita un poco más de tiempo para madurar y más de una iteración para que quede como queremos. Es normal que el mismo post y la idea principal comience a evolucionar conforme escribimos, quizás algunas cosas que habíamos escrito ya no tienen cabina con el rumbo del post y es necesario borrarlas.

Hay que darle tiempo al post y darnos tiempo nosotros.

Ya tengo mi post y ahora?

Ya por fin llegamos a una versión con la que estamos satisfechos. Una buena idea es mostrárselo a alguien en quien confiemos para que nos pueda dar retroalimentación. Quizás de esa retroalimentación será necesario regresar y hacer cambios, quizás no.

Si ya me siento con la confianza de hacerlo público entonces ha llegado el momento de mostrarlo al mundo.

Una opción es obviamente el blog de michelada.io pero nuestro trabajo no termina ahí. Lo ideal sería el que pudiésemos hacer "Cross-Posting" a servicios como (cuantos más mejor):

  • Mi blog personal
  • Medium
  • Dev.to

Si utilizamos herramientas como Twitter o LinkedIn igualmente publicarlo ahí. Además de mandarlo a agregadores de tecnología, por ejemplo en el caso de Ruby están las opciones:

Estoy seguro que para otras tecnologías existen agregadores similares.

Comentarios finales

Como empresa nos ayuda mucho que ustedes puedan compartir los temas que les interesa ya que demuestra de alguna forma el conocimiento que tienen y en ocasiones eso ayuda en la referencia con los posibles clientes.

Pero creo que lo más importante es que a final de cuentas este tipo de actividades apoya a establecer sus conocimientos y a definir su curriculum, no solamente en michelada.io pero hacia afuera.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment