#TechnicalWriting#LLMs#AI#GenerativeAI#DevRel#UXWriting: "In 2024 we’re still rewarding docs sites and focusing our efforts on getting docs up and running, as if we were creating primitive unicellular organisms for the first time. We can and will do better than this. The next stage of the tech writing’s evolution is to integrate with the bigger product lifeform, a step that will finally allow us to leverage things like true docs observability instead of flailing at useless performance metrics. Whether to hire a technical communications specialist will no longer be a question, as it’s no longer a question to have soundtracks in films.
It doesn’t really matter how technical or complex a software product will be. Documentation as a behavior of software components will consistently happen in CLIs, GUIs, developer tools, APIs, and other aspects of software. Wherever there’ll be points of connection between humans and software, there’ll be a need for meaningful, helpful words. If becoming a tech therapist requires merging technical writing with DevRel, the docs are everywhere paradigm will require tech writers and UX writers to merge into a unified professional role, the product writer." https://passo.uno/tech-writing-predictions-2049/
Does anyone have any useful data on using exclamation marks (or rather, not using them) in customer communications that will wield a bit more authority than my current rationale: “it gives me the ick”?
#uxwriting
Faire du contenu de qualité (contenu lié à l'activité de votre produit ou contenu d'interaction / navigation) ne suffit pas, encore faut-il le présenter de manière lisible, compréhensible, simple et facile à comprendre.
Un UX writer n'est pas juste là pour compléter des tableaux Excel avec des textes qui seront mis en page plus tard, c'est un travail en collaboration avec les UX designers, UI designers, product designers (nommez-les comme vous voulez) ⬇️
#UXWriting
Ex 2 : ce mail des impôts qui donne des directives sur comment modifier son avance de crédit d'impôts.
Les instructions sont paumées au milieu du texte, il faut jongler entre le mail et son espace perso (en espérant que le mode d'emploi donné dans le mail corresponde encore au parcours dans l site parce que ça c'est souvent pas mis à jour 😁 )
#UXWriting
Pour illustrer qu'il est possible de faire mieux que des pavés de texte, voici un exemple avec un mail issu de Parcoursup. Il y a le mail original et le mail que nous avons retouché (pas sûre qu'il soit arrivé en prod)
Pour des raisons pratiques d'un truc nommé pérennité des liens hypertextes, gardez toujours le même nom sur un PDF, même si il y a des mises à jour.
Il est tout à fait possible de mettre la date de mise à jour ou le numéro de version en clair à côté du lien de téléchargement, ainsi que sur le document en lui-même.
(ces règles s'appliquent à tout pdf nommé de manière pas clair, y compris un bête document.pdf, voilà bisous)
Qui n'a pas utilisé du lorem ipsum (à vos souhaits) un jour ?
Moi je l'ai fait et je sais que c'est un truc à bannir.
Je l'ai dit tantôt : le contenu est l'élément premier de votre produit.
Il est donc nécessaire de faire un inventaire du contenu existant et de celui à créer (vous n'aurez pas tout bien sûr, mais faites le point là-dessus très vite). ⬇️
#UXWriting du jour : tronquer les textes ? Mauvaise idée.
Alors que le numérique offre (contrairement au papier) la possibilité de rendre les contenants élastiques, une tendance a émergé depuis des années, à savoir : faire des contenants visuellement parfaits en premier et tenter de faire rentrer les contenus au chausse-pied.
Bilan : les textes (ce sont souvent le textes) sont réduits à éléments devant s'adapter à leur environnement mal conçu.
Et ça peut donner des trucs... hmmm ⬇️
#UXWriting
Autre exemple : votre template est super chiadé, bien aligné... Mais une partie des contenus prévus pour aller dedans sont plus longs.
Vous n'avez pas regardé les contenus réels de manière exhaustive. Résultat, ça déborde.
Alors, posez-vous la question : si vous faites le choix de tronquer du texte ou de faire des contenants strictes, quels sont vos arguments ? Comment pouvez-vous justifier vos choix ?
Mon conseil : Pensez à récupérer un maximum de vrais contenus (contexte et métier) pour travailler dessus avant de penser à vos interfaces
#UXWriting
Concernant la capture écran de Indeed, vous êtes nombreux à me dire que l'interface est prévue pour la langue anglaise.
Oui c'est vrai, c'est l'explication, mais, Indeed est un poids lourd du marché, un méta moteur de recherche d'emploi présent dans plus de 50 pays (y compris en Antarctique 😲).
"C'est le seul métamoteur de recherche d'emploi présent sur 7 continents"
Alors quand on a une telle aura et qu'on souhaite garder sa place de leader, on soigne ses internationalisations.
Lorsqu'on utilise un produit numérique, on vient pour le contenu. On le consulte, on le crée, on le manipule.
On ne vient pas pour les aspects purement visuels ou techniques.
Le contenu est donc l'élément premier de votre produit.
Ca peut être du texte, des images, du son, des vidéos, des graphes, des données, des PDF, et les mails aussi (ne pas oublier).
Il y a aussi tous les contenus liés à l’interaction et la navigation (boutons, menus, ...)