Confidencial de Windows: Cuando el cristal tiene el color de las características
Si usted no puede explicar su función sin utilizar palabras, entonces no espere que nadie te entiendo.
Raymond Chen
Una de las cosas que hay que recordar al escribir documentación para el consumo externo es que la persona está leyendo la documentación porque no saben todo lo sabe. Cuando usted está tratando de explicar su función a alguien, usted necesita parar y sacar sus gafas de color característica.
Después de todos estos años, todavía no tenía ninguna pista lo que era Windows CardSpace. En una discusión acerca de Windows Live ID (que entonces se conocía), alguien respondió a una pregunta con una cita de una sección de una página Web titulada "Cómo hace Windows Live ID participar en la identidad metasistema y trabajo con InfoCard":
"Microsoft está trabajando con otros en la industria para crear un metasistema de identidad que trae los proveedores de identidad existentes y futuros en un ecosistema de identidad conectado y permite a los usuarios finales para controlar el uso de sus identidades. El servicio de Windows Live ID participará en el metasistema de identidad como proveedor de uno identidad entre muchos, capaces de aceptar los reclamos de otros proveedores de identidad y transformarlos para que puedan ser usados dentro de Microsoft online services."
Aquí está lo que el párrafo sonaba como a mí:
"Microsoft está trabajando con otros en la industria para crear un rumor que trae palabras actuales y futuros en un rumor y palabrejas usuarios a la palabra de moda. El servicio de Windows Live ID participará en la palabra de moda como una palabra de moda entre muchos, moda y moda les que les permita la palabra de moda."
En ese momento, detuvo la lectura y preguntó si alguien era capaz de traducir ese párrafo en inglés. Nadie podría, pero algunas personas privada me dijeron: "Pensé lo mismo, pero tenía demasiado miedo a decir nada".
Todos mis intentos de aprender acerca de CardSpace llevaron a ninguna parte. La gente que escribió la documentación de CardSpace asume que el consumidor ya estaba familiarizado con CardSpace. Con alegría explicaron que CardSpace logrado tarjetas, que era la unidad de identidad basada en notificaciones. En otras palabras: "CardSpace maneja palabras, que son la unidad de la palabra de moda de moda". Me di por vencido de leer la documentación en ese momento.
Este es otro ejemplo de uno de mis intentos fallidos para averiguar la naturaleza escurridiza de CardSpace:
Una demostración llevada a cabo por el jefe de proyecto de CardSpace comenzó con una sección sobre "Lo que el usuario final experimentará." Que fue genial, porque comprendí lo que significaba para mí, el hombre que no tenía ni idea lo que CardSpace se supone que es o cómo funciona.
Ese demo consistió en una página Web que, dijo, "Haga clic en el botón de abajo para enviar una tarjeta".
OK, la demo ya me había perdido de su primera captura de pantalla.
"¿Qué es una tarjeta"? Me preguntaba. "Es este me pide mi tarjeta de crédito?"
Alimenta a través de todos modos. La demo haga clic en el botón, y apareció un nuevo cuadro de diálogo. "Aquí, usted puede ver que tengo una selección de tarjetas disponibles."
Todavía no me dijo qué una tarjeta era. ¿De dónde vienen las tarjetas? ¿Por qué son útiles? ¿Vienen de las hadas de la tarjeta de CardSpace?
Sin embargo me quedé con la demo. La demostración había seleccionado una tarjeta y le mostró un montón de XML en la pantalla.
¿Ese fue el UX? Hice clic en un botón no entendía y mostró un diálogo llenado de frijoles mágicos. ¿Luego había seleccionado uno de los frijoles mágicos, y algunos XML demostró para arriba en la pantalla?
Fui a la ayuda en línea para que CardSpace. Pensé, "ésta es la documentación escrita específicamente para usuarios no técnicos. Seguramente esto explicará a mí la idea de esta cosa de CardSpace."
Bueno, al menos que la documentación era un poquito mejor. La ayuda en línea me dijo que CardSpace es "un sistema para crear relaciones con sitios Web y servicios".
Eso no suena como algo que quería. No quería una relación con un sitio Web. Yo sólo quería visitar CNN y leer el día Inicio de historias.
En ese momento, me di por vencido totalmente. Me di cuenta de que es una cosa si tu directivos no pueden explicar su proyecto. Es otra cosa completamente cuando usted mismo no puede explicar la naturaleza de su propio proyecto.
Para ser justos, el equipo de CardSpace constituyó por su entorno. El producto fue diseñado para y vivió en el mundo de la identidad digital. Una característica común del mundo de la identidad digital es que nadie allí es capaz de describir lo que hacen sin recurrir a palabras de moda. Cuanto más tiempo pasa tiempo en un mundo donde todo el mundo habla de una cierta manera, cuanto más usted asume que todo el mundo habla de esa manera, incluso si es sólo la gente de su pandilla poco que hablar de esa manera.
Usted debe tener la conciencia de sí mismo para darse cuenta de que estás haciendo este error y Ponte en los zapatos de alguien que no ha pasado los últimos años habla jerga peculiar de su campo. Sólo cuando la brecha entre los iniciados y los forasteros puede decir que usted ha logrado comunicar.
.jpg)
Raymond Chenidénticamente titulado libro (Addison-Wesley, 2007) y del sitio Web, The Old New Thing, ocuparse de la historia de Windows, programación de Win32 y los riesgos de seguridad que plantea molestos archivos MIDI.