Vie secrète de Windows : Mettez-vous à la place de votre public
Si vous ne pouvez pas expliquer votre fonction sans utiliser de mots à la mode, alors ne vous attendez quelqu'un de vous comprendre.
Raymond Chen
Une des choses que vous avez à retenir lors de l'écriture de documents destinés à la consommation externe, c'est que la personne lit votre documentation car ils ne savent pas tout ce que vous savez. Lorsque vous essayez d'expliquer votre fonction à quelqu'un, vous devez arrêter et enlever vos lunettes de couleur caractéristique.
Après toutes ces années, je n'avais encore aucune idée de ce qui était Windows CardSpace. Dans une discussion sur Windows Live ID (comme on l'appelait alors), quelqu'un a répondu à une question en citant un article d'une page Web intitulée « Comment fait Windows Live ID participer dans l'identité métasystème et travail avec InfoCard » :
"Microsoft travaille avec d'autres dans l'industrie pour créer un métasystème d'identités qui apporte les fournisseurs d'identité existants et futurs dans un écosystème d'identité connecté et permet aux utilisateurs de contrôler l'utilisation de leur identité. Le service Windows Live ID participera dans le métasystème d'identité en tant que fournisseur d'une identité parmi tant d'autres, en mesure d'accepter les revendications des autres fournisseurs d'identité et de les transformer afin qu'ils puissent être utilisées au sein de Microsoft online services. »
Voici ce qui ressemblait à ce paragraphe pour moi :
"Microsoft travaille avec d'autres dans l'industrie pour créer un mot à la mode qui apporte des mots à la mode actuelles et futures dans un mot à la mode et des utilisateurs de mots à la mode à mot à la mode. Le service Windows Live ID participera dans le mot à la mode comme un mot à la mode parmi tant d'autres, en mesure de mot à la mode et de buzzword eux afin qu'ils puissent le mot à la mode. »
À ce moment-là, j'ai arrêté la lecture et a demandé si quelqu'un était capable de traduire ce paragraphe en anglais. Personne ne pouvait, mais quelques personnes privé m'a dit, « J'ai pensé la même chose, mais avait trop peur de dire quoi que ce soit. »
Toutes mes tentatives pour en savoir plus sur CardSpace a mené nulle part. Les gens qui ont écrit la documentation CardSpace suppose que le consommateur était déjà familiarisé avec CardSpace. Ils ont expliqué gaiement que CardSpace géré les cartes, qui était l'unité de l'identité basée sur les revendications. En d'autres termes : « CardSpace gère les mots à la mode, qui sont l'unité de buzzword buzzword. » J'ai laissé tomber la lecture de la documentation à ce moment-là.
Voici un autre exemple de l'un de mes tentatives infructueuses de comprendre le caractère insaisissable de CardSpace :
Une démonstration effectuée par le gestionnaire de projet de CardSpace a commencé avec une section sur « Ce que l'utilisateur final sera expérience. » C'était génial, parce que je ne voyais pas ce que cela signifiait pour moi, le gars qui n'avait aucune idée ce que CardSpace est censé pour être ou comment il fonctionne.
Cette démo se composait d'une page Web qui dit, « Cliquez sur le bouton ci-dessous pour envoyer une carte. »
OK — la démo avait déjà perdu moi depuis sa toute première capture d'écran.
« Ce qui est une carte? » Je me demandais. « Est ce me demande pour ma carte de crédit? »
J'ai alimenté par quand même. La démo a cliqué sur le bouton, et une boîte de dialogue Nouveau surgi. « Ici, vous pouvez voir que j'ai une sélection de cartes disponibles. »
Il encore n'avait pas m'a dit ce que la carte a été. D'où viennent les cartes ? Pourquoi sont-ils utiles ? Ils viennent la fée de carte CardSpace ?
J'ai collé avec la démo néanmoins. La démonstration choisi une carte et puis a montré un tas de XML à l'écran.
C'était l'UX ? J'ai cliqué sur un bouton, je ne comprenais pas et a montré un dialogue rempli de haricots magiques. Ensuite, j'ai choisi un des haricots magiques, et certains XML affiché sur l'écran ?
Je suis allé à l'aide en ligne pour CardSpace. J'ai pensé, "Ceci est la documentation écrite spécifiquement pour les utilisateurs non-techniques. Sûrement cela va m'expliquer tout l'intérêt de cette chose de CardSpace."
Eh bien, au moins que la documentation était un tout petit peu mieux. L'aide en ligne m'a dit que CardSpace est « un système pour tisser des liens avec des sites Web et services ».
Cela n'a pas ressembler à ce que je voulais. Je ne voulais pas une relation avec un site Web. Je voulais juste visiter CNN et lire de la journée les plus marquants.
À ce moment-là, j'ai laissé tomber tout à fait. J'ai réalisé que c'est une chose si votre cadres supérieurs ne peuvent pas expliquer votre projet. C'est une autre chose entièrement lorsque vous vous ne peut pas expliquer la nature de votre projet.
Pour être juste, l'équipe de CardSpace a été mis en place par leur environnement. Le produit a été conçu pour et a vécu dans le monde de l'identité numérique. Une propriété commune du monde identité numérique est qu'il n'ya personne est capable de décrire ce qu'ils font sans avoir recours aux mots à la mode. Plus vous passez de temps dans un monde où tout le monde parle d'une certaine manière, plus vous supposer que tout le monde parle de cette façon, même si ce sont seulement les gens dans votre petite clique qui parlent de cette façon.
Vous devez avoir la conscience de soi pour se rendre compte que vous faites cette erreur et mettez-vous à la place de quelqu'un qui n'a pas passé les dernières années plusieurs parlant le jargon particulier de votre champ. Uniquement lorsque vous combler le fossé entre initiés et exclus pouvez vous dire que vous avez réussi à communiquer.
.jpg)
Raymond ChenWeb site, The Old New Thing et identiquement intitulé livre (Addison-Wesley, 2007) traitent de l'histoire Windows, programmation Win32 et les risques de sécurité posés par les fichiers MIDI ennuyeux.