Share
Aujourd'hui, j'aimerais prendre quelques instants pour nous concentrer sur quelque chose qui nous concerne tous, mais qui n'est pas spécifiquement lié au code. Je fais référence aux personnes qui commandent les livres et les articles de magazines traditionnels que vous lisez et apprenez tous les jours..
Ce que vous ne réalisez peut-être pas, c’est que les éditeurs ont tendance à imposer aux auteurs des directives étonnamment strictes..
Pour ceux d'entre vous qui n'ont pas encore contribué à un livre technique ou à un magazine - ou même à certains blogs commerciaux - vous ne réalisez peut-être pas que les éditeurs ont tendance à appliquer des directives étonnamment strictes aux écrivains..
Les éléments mentionnés ci-dessus ne représentent qu'une petite partie des restrictions qui pèsent sur les épaules d'un rédacteur technique. Cela se traduit par: en plus de déchiffrer la meilleure explication possible de technologies extrêmement complexes, un rédacteur technique doit également parvenir à adapter son contenu aux limites des directives prédéterminées confuses d'un éditeur..
Pour la cerise sur le morceau - et pour exercer encore plus de pression sur le rédacteur - diverses échéances (assez intenses) seront définies, afin de s'assurer que le livre est terminé à temps. Bien que cela soit certainement compréhensible, les éditeurs ont souvent tendance à être trop ambitieux dans les dates qu'ils ont choisies, ce qui ne tient pas compte du travail à temps plein de l'auteur et des autres responsabilités.
Ce modèle est obsolète et en voie d'extinction, s'il n'est pas abordé et modernisé.
Enseigner le code est, à bien des égards, un art.
Avant de continuer à nous attaquer aux éditeurs traditionnels, il est important de comprendre Pourquoi ils font ça. Considérons un magazine avec un nombre fini de pages disponibles pour un contenu particulier, par exemple cinq pages. Si c'était la seule restriction, cela resterait difficile pour l'écrivain. Enseigner le code est, à bien des égards, un art. Cela nécessite à la fois une compréhension de la technologie et la capacité de l'expliquer de manière à ce que tout le monde puisse la comprendre. Comment placez-vous un compte de mots abstrait sur l'art et l'explication? Eh bien, la réponse est que vous ne pouvez pas - du moins pas sans sacrifices considérables et édition.
Continuons; Maintenant que nous avons établi que le magazine X ne peut contenir que cinq pages, la restriction suivante consiste à trouver le moyen de mettre votre article dans un gabarit prédéfini, c'est-à-dire inutile de le dire. de toute façon, forme ou forme pour le processus d'écriture. C’est là que les exigences de nombre de mots d’image et par section entrent en jeu.
Imaginez que vous deviez décrire le fonctionnement de ce code en 25 à 35 mots. Terminé? Maintenant, imaginez les sacrifices que vous auriez à faire pour pouvoir expliquer votre explication suffisamment pour répondre à cette exigence! Qui profite de cela?
Le problème réside dans le fait que ces modèles et macros ne prennent pas en compte le processus d'écriture.
Du point de vue d'un non-auteur, on comprend parfaitement pourquoi il peut être nécessaire de définir ces restrictions. Considérez les éditeurs qui organisent et éditent des centaines de livres par an. Dans ces cas, il devient rapidement essentiel - pour des raisons de santé - de préparer des modèles, ainsi que des documents et macros Word considérablement complexes pour automatiser autant que possible..
Le problème réside dans le fait que ces modèles et macros ne commencent même pas à prendre en compte le processus d'écriture. Maintenant, plutôt que de se concentrer sur l'essentiel (expliquer le code compliqué), l'auteur est contraint de consacrer beaucoup de temps et d'efforts à déchiffrer comment utiliser une macro Word particulière, ou formater son document, conformément aux directives de l'éditeur..
L’un des trois résultats peut être qu’un éditeur impose des pages d’exigences à un écrivain, qui ne veut rien de plus que d’enseigner une technologie particulière à d’autres - et peut-être même payer l’hypothèque en même temps. (Si vous pensez que les auteurs de vos livres techniques préférés le font pour leur argent, détrompez-vous.)
Je suis sûr que vous pouvez deviner quelle option ci-dessus a tendance à être la plus populaire.
A un moment, j'avais des exigences similaires pour les contributeurs Nettuts +.
Je dois admettre que, à un moment donné, j'avais des exigences similaires pour les contributeurs Nettuts + et les rédacteurs. Heureusement, le format d'un blog impose naturellement des exigences moins strictes. Une exigence de nombre de mots par section est stupide et dénuée de sens pour un blog. Cela dit, j’ai toujours mis l’accent sur le nombre de mots, la fourniture d’images et l’utilisation de notre modèle HTML spécifique aux Nettuts lors de la préparation de nouveaux tutoriels..
Pourquoi? Eh bien, pour les mêmes raisons que celles des éditeurs traditionnels: mon travail est plus facile, lorsque l'article correspond à ma présentation prédéterminée pour un article Nettuts +.
Ce que je n’ai pas pris en considération, c’est le nombre d’écrivains potentiels que j’ai écartés par inadvertance en établissant ces exigences. Qui a honnêtement le temps de travailler dans les limites du modèle de quelqu'un d'autre? Lorsque le temps est une denrée précieuse (en particulier pour les personnes occupant un emploi à temps plein et leur famille), ces limites ne sont que dissuasives..
Ces jours-ci, lors de la commande de nouveaux contenus, mon seul objectif est de rendre le processus de rédaction de l'auteur aussi simple et naturel que possible..
Maintenant que j'ai mûri en tant qu'éditeur de Nettuts +, lorsque je travaille avec de nouveaux auteurs, je ne demande plus qu'un fichier Markdown, qui, pour ceux qui ne sont pas familiers, est un pseudo langage que les développeurs, en particulier, ont tendance à préférer. Markdown élimine complètement les éléments visuels et le formatage du processus d'écriture, comme cela devrait être le cas - en particulier dans notre secteur. Sinon, s'ils ne se sentent pas à l'aise avec Markdown, ils sont libres d'utiliser n'importe quoi d'autre pour faire leur travail..
Maintenant que j'ai mûri en tant qu'éditeur de Nettuts +, lorsque je travaille avec de nouveaux auteurs, je ne demande plus qu'un fichier Markdown..
Peut-être que cette méthode me demandera peut-être un peu plus de travail, mais elle en vaut absolument la peine. Je veux que nos écrivains se concentrent sur rien d’autre que d’expliquer le plus efficacement possible des technologies compliquées. Nous nous occuperons du reste. Si seulement tous les éditeurs adoptaient un modèle similaire.
Accentsconagua