Hoy, me gustaría tomarme unos momentos para centrarme en algo que nos afecta a todos, pero que no está específicamente relacionado con el código. A lo que me refiero es a las personas que encargan los libros tradicionales y los artículos de revistas que lees y aprendes todos los días..
Lo que quizás no se dé cuenta es que los editores tienen una tendencia a imponer pautas sorprendentemente estrictas a los escritores.
Para aquellos de ustedes que aún no han contribuido a un libro o revista técnica, o incluso a algunos blogs comerciales, lo que quizás no se dé cuenta es que los editores tienen una tendencia a imponer pautas sorprendentemente estrictas a los escritores..
Los elementos mencionados anteriormente representan solo una pequeña parte de las restricciones que descansan sobre los hombros de un escritor técnico. Esto se traduce en: además de descifrar la mejor manera de explicar las tecnologías considerablemente complejas, un escritor técnico también debe de alguna manera adaptarse a su contenido dentro de los límites de las confusas pautas predeterminadas de un editor..
Para la guinda del caso, y para ejercer aún más presión sobre el escritor, se establecerán una variedad de fechas límite (bastante intensas) para garantizar que el libro se complete a tiempo. Si bien esto es ciertamente comprensible, muchas veces, los editores tienden a ser demasiado ambiciosos en las fechas que eligen, lo que no tiene en cuenta el trabajo de tiempo completo del escritor y otras responsabilidades..
Este modelo está desactualizado y se acerca rápidamente a la extinción, si no se aborda y moderniza.
El código de enseñanza es, en muchos sentidos, un arte..
Antes de continuar seleccionando editores tradicionales, es importante entender primero por qué ellos hacen esto. Considere una revista con un número finito de páginas disponibles para un contenido en particular, por ejemplo, cinco páginas. Si esta fuera la única restricción, todavía sería difícil para el escritor. El código de enseñanza es, en muchos sentidos, un arte. Requiere tanto una comprensión de la tecnología como la capacidad de explicarlo de tal manera que todos puedan comprenderla. ¿Cómo colocas un recuento de palabras en el arte y la explicación? Bueno, la respuesta es que no puedes, al menos no sin un considerable sacrificio y edición..
Sigamos adelante; Ahora que hemos establecido que la Revista X solo puede tener espacio para cinco páginas, la siguiente restricción viene en la forma de encontrar una forma de meter su artículo en una plantilla de diseño predefinida, es decir, no hace falta decirlo, no es propicio en De cualquier forma, forma o forma al proceso de escritura. Aquí es donde los requisitos de conteo de palabras por imagen y por sección entran en juego.
Imagine que le dicen que necesita describir cómo funciona este fragmento de código en 25-35 palabras. ¿Hecho? Ahora, ¡imagina los sacrificios que tendrías que hacer, para disimular tu explicación lo suficiente como para cumplir con ese requisito! ¿Quién se beneficia de esto??
El problema radica en el hecho de que estas plantillas y macros no tienen en cuenta el proceso de escritura.
Desde la perspectiva de un no escritor, es perfectamente comprensible por qué podría ser necesario establecer estas restricciones. Considere a los editores que organizan y editan cientos de libros por año. En estos casos, rápidamente se vuelve esencial, para su propia cordura, preparar plantillas y macros y documentos de Word significativamente complejos para automatizar todo lo posible..
El problema radica en el hecho de que estas plantillas y macros ni siquiera comienzan a tomar en consideración el proceso de escritura. Ahora, en lugar de centrarse en lo que es más importante (explicando el código complicado), el escritor se ve obligado a hacer un esfuerzo y tiempo considerables para descifrar cómo usar una macro de Word en particular, o formatear su documento, según las pautas del editor.
Uno de los tres resultados puede ser el resultado de un editor que impone páginas de requisitos a un escritor, que no quiere nada más que enseñar una tecnología particular a otros y, quizás, pagar la hipoteca en el proceso. (Si crees que los escritores de tus libros técnicos favoritos lo hacen por dinero, piénsalo de nuevo).
Estoy seguro de que puedes adivinar cuál de las opciones anteriores suele ser la más popular.
En un momento dado, tuve requisitos similares para los contribuyentes de Nettuts +.
Debo admitir que, en un momento dado, tuve requisitos similares para los colaboradores y escritores de Nettuts +. Afortunadamente, el formato de un blog naturalmente hace que los requisitos sean menos estrictos. Un requisito de conteo de palabras por sección es tonto y sin sentido para un blog. Dicho esto, todavía enfaticé los recuentos de palabras, proporcioné imágenes y usé nuestra plantilla especial de HTML específica de Nettuts, al preparar nuevos tutoriales..
¿Por qué? Bueno, por la misma razón que lo hacen las editoriales tradicionales: mi trabajo es más fácil, cuando el artículo se ajusta a mi diseño predeterminado para un artículo de Nettuts +.
Lo que no tuve en cuenta fue el número de escritores potenciales que, sin querer, eliminé, al establecer estos requisitos. ¿Quién, honestamente, tiene tiempo para trabajar dentro de los límites de la plantilla de otra persona? Cuando el tiempo es un bien valioso (especialmente para aquellos con empleos y familias de tiempo completo), estos confines no son más que un elemento disuasorio..
En estos días, mi único objetivo, al encargar nuevo contenido, es hacer que el proceso de escritura para el autor sea lo más sencillo y natural posible..
Ahora que he madurado como editor de Nettuts +, cuando trabajo con nuevos autores, solo solicito un archivo de Markdown, que, para aquellos que no están familiarizados, es un pseudo-lenguaje que los desarrolladores en particular prefieren. Markdown hace que las imágenes y el formato queden completamente fuera del proceso de escritura, como debería ser el caso, especialmente en nuestra industria. Alternativamente, si no se sienten cómodos con Markdown, pueden usar cualquier otra cosa para hacer el trabajo.
Ahora que he madurado como editor de Nettuts +, cuando trabajo con nuevos autores, solo solicito un archivo de Markdown.
Tal vez este método pueda hacer un poco más de trabajo por mi parte, pero vale la pena de manera absoluta y positiva. Quiero que nuestros escritores se centren en nada más que en explicar las tecnologías complicadas de la manera más efectiva posible. Nosotros nos encargaremos del resto. Si solo todos los editores adoptaran un modelo similar..