Écriture

Révision: Une nuit à Camden

Cette semaine, au travail, nous avons lancé un portail combinant documentation utilisateur, REST et API GraphQL pour un nouveau produit. Je suis très satisfait du résultat. Mais il y a beaucoup d’autres choses qui se passent en ce moment, ce qui ne m’a pas laissé le temps de me consacrer au blog. Normalement, lorsque je retire un article de mes archives, je le remanie complètement et je le mets à jour. Mais celui-ci est un instantané d’une époque particulière, au milieu des années 1990, lorsque Londres était l’endroit où il fallait être et que je faisais mes débuts dans la presse. Je le présente donc dans sa forme originale de 1995.

Premiers pas avec Automator

Bien que ce site Web soit à peu près conforme à mes attentes, je continue à peaufiner le CSS et à ajouter des fonctionnalités. Dernièrement, j’ai ajouté quelques réseaux sociaux supplémentaires à la page d’accueil et quelques options supplémentaires aux boutons de partage social sur les articles. Mais il y a une chose que je voulais vraiment ajouter, c’est l’option d’écouter les articles. J’ai envisagé des services qui offrent un niveau gratuit, tels que Trinity Audio et Speechify, mais j’avais trop de contenu existant. Par ailleurs, la version IA de Speechify de ma propre voix était effrayante. Je pouvais dire qu’il ne s’agissait pas d’un véritable être humain, mais à peine. À la recherche d’une solution à coût zéro, j’ai donc fini par utiliser l’application Automator de macOS. J’ai également décidé de ne pas convertir les articles contenant des exemples de code, car il est préférable de les confier à des lecteurs d’écran spécialisés.

Coup de projecteur rétro: Andy Remic et les 8 bits

Andrey John “Andy” Remic était écrivain, cinéaste et passionné d’informatique rétro. En février 2022, il est décédé d’un cancer à l’âge de 50 ans, laissant derrière lui sa femme Linda et ses deux enfants. Avant que sa santé ne commence à se détériorer, il travaillait sur un nouveau documentaire intitulé “The 8-Bit Evolution”, qui examinait les recréations modernes et les évolutions des systèmes 8 bits. Il prévoyait de m’interviewer en raison de mon implication dans le projet Mega 65. Nous avons eu une longue conversation sur Facebook qui a abouti à ce que je fournisse des réponses écrites à des questions d’interview qui seront filmées à une date ultérieure. Je pense qu’il s’est écoulé suffisamment de temps pour que je puisse maintenant partager certaines de mes réponses. Mais tout d’abord, j’aimerais en savoir plus sur Andy.

L’art du récit

En tant qu’êtres humains, les deux principaux moyens d’apprentissage sont le jeu et l’histoire. Lorsque vous essayez d’apprendre une nouvelle tâche, il est souvent plus facile d’apprendre par essais et erreurs que par l’enseignement traditionnel. On dit souvent que les erreurs et les échecs sont les meilleurs professeurs. Mais parfois, il est préférable d’apprendre des expériences des autres pour éviter de répéter leurs erreurs. Les histoires sont importantes. Elles nous permettent d’atteindre un public non seulement au-delà de notre propre géographie, mais aussi au-delà de notre propre durée de vie.

Ma liste d‘auteurs pour enfants (en anglais)

Cette semaine, j’ai présenté un exposé sur les CMS, les CCMS et les solutions connexes lors de la conférence sur les communications techniques TCUK23 en Angleterre. J’avais l’intention de rédiger mon autre idée d’exposé en tant qu’article de cette semaine. Mais alors que je traînais avec ma tribu (les écrivains), certains d’entre nous ont commencé à parler de leurs auteurs de livres pour enfants préférés. J’ai promis de partager ma liste de recommandations.

Écrire américain quand ce n'est pas son premier dialecte anglais

Lorsque j’ai commencé à écrire, j’utilisais l’anglais d’Oxford. C’est celui qui contient les orthographes -ize (correctes). Bien qu’en tant que journaliste, on m’ait dit d’éviter la ponctuation inutile, j’évite donc la virgule d’Oxford (sérielle). Mais lorsque je suis devenu rédacteur technique, je me suis retrouvé à utiliser l’anglais américain dans mon travail quotidien. Finalement, j’en ai eu assez de passer d’une langue à l’autre et j’ai décidé d’utiliser exclusivement l’anglais américain. Dans cet article, j’utiliserai le terme “colonial” pour désigner tous les dialectes non américains de l’anglais.

Migrer du Markdown à la rédaction structurée

Je suis un grand fan de Markdown. Il est parfait pour les wikis et la rédaction de contenu pour les sites statiques (la plupart du contenu de ce site est rédigé à l’aide de ce langage). Mais il arrive un moment dans la documentation d’un logiciel où la taille du projet ou le nombre de contributeurs a augmenté au point qu’il est nécessaire d’imposer une certaine structure. C’est à cela que servent les documents structurés. L’une des principales raisons pour lesquelles vous souhaitez le faire est de séparer le contenu de la présentation. Cela vous permet de présenter le contenu de différentes manières sur différents supports, tels que l’imprimé et l’Internet. Mais vous avez déjà tout ce contenu en Markdown. Quelles sont donc les options qui s’offrent à vous: Vous pouvez tout recréer à partir de zéro (ne le faites pas). Ou vous pouvez migrer de Markdown vers un système de rédaction structuré.

Créer un guide de rédaction (pour l'anglais)

Lorsque je suis passé du journalisme à la rédaction technique, les deux choses qui m’ont le plus manqué sont les guides de style et les rédacteurs. Lorsque les services de rédaction technique sont réduits, les rédacteurs sont les premiers à être licenciés. À trois reprises, quand j’étais le seul rédacteur d’une organisation, j’ai créé mon adéquat guide de style à partir de rien. Mais même quand il existe un guide de style, il peut ne pas être à jour en ce qui concerne la terminologie moderne ou l’utilisation du langage. Si votre travail consiste à rédiger des contenus destinés aux clients, surtout si vous n’avez pas suivi de formation de rédacteur, vous avez besoin d’un guide de style.