Windows-informazioni riservate: Occhiali dai colori stravaganti
Se si non può spiegare la funzione senza l'uso di parole d'ordine, quindi non aspettatevi qualcuno a capirla.
Raymond Chen
Una delle cose che devi ricordare durante la scrittura di documentazione per il consumo esterno è che la persona sta leggendo la documentazione perché non sanno tutto ciò che sapete. Quando si sta cercando di spiegare la vostra caratteristica di qualcuno, è necessario fermarsi e togliere gli occhiali color caratteristica.
Dopo tutti questi anni, ho non avuto ancora alcun indizio che cosa era Windows CardSpace. In una discussione su Windows Live ID (come era conosciuto allora), qualcuno ha risposto a una domanda citando da una sezione di una pagina Web intitolata "Come fa Windows Live ID partecipare in the Identity metasistema e lavoro con InfoCard":
"Microsoft sta lavorando con gli altri del settore per creare un metasistema delle identità che porta i provider di identità esistenti e futuri in un ecosistema connesso identità e consente agli utenti di controllare l'utilizzo delle loro identità. Il servizio Windows Live ID parteciperà il metasistema delle identità come provider di identità di uno tra i tanti, in grado di accettare richieste da altri provider di identità e trasformarli in modo che possono essere utilizzati all'interno di Microsoft online services."
Ecco che cosa quel punto sembrava a me:
"Microsoft sta lavorando con gli altri del settore per creare uno slogan che porta buzzwords esistenti e futuri in un parolone e buzzwords utenti buzzword. Il servizio Windows Live ID parteciperà la parola d'ordine come una parola d'ordine tra i tanti, in grado di buzzword e buzzword loro modo possono buzzword."
A quel punto, ho smesso di leggere e ha chiesto se qualcuno è stato in grado di tradurre tale paragrafo in inglese. Nessuno poteva, ma poche persone privatamente mi ha detto, "Ho pensato la stessa cosa, ma era troppa paura di dire qualcosa."
Tutti i miei tentativi di conoscere CardSpace ha portato da nessuna parte. Chi ha scritto la documentazione CardSpace presuppone che il consumatore era già familiare con CardSpace. Allegramente, hanno spiegato che CardSpace gestito carte, che era l'unità di identità basata su attestazioni. In altre parole: "Parole d'ordine, che sono l'unità di buzzword buzzword gestisce la CardSpace." Ho smesso di leggere la documentazione relativa a quel punto.
Ecco un altro esempio di uno dei miei tentativi falliti di capire la natura sfuggente di CardSpace:
Una demo diretta da CardSpace project manager ha cominciato con una sezione su "Che cosa l'utente finale esperienza." Che è stato grande, perché ho potuto vedere che cosa significasse per me — il ragazzo che non aveva idea che cosa CardSpace è supposto per essere o come funziona.
Quella demo consisteva in una pagina Web che ha detto, "Clicca sul pulsante qui sotto per inviare una carta".
OK — la demo mi aveva già perso dal suo primissimo screenshot.
"Che cosa è una carta"? Mi chiedevo. "È questo mi chiede per la mia carta di credito?"
I alimentato attraverso comunque. La demo cliccato il pulsante, e spuntato una nuovo dialogo. "Qui, si vede che ho una selezione di carte disponibili."
Ancora non aveva mi ha detto che una scheda era. Da dove provengono i biglietti? Perché sono utili? Essi vengono dalla fata scheda CardSpace?
Sono bloccato con la demo, comunque. La dimostrazione selezionato una carta e poi ha mostrato un sacco di XML sullo schermo.
Che era la UX? Ho cliccato un tasto non capisco ed è stato mostrato un dialogo pieno di fagioli magici. Poi ho selezionato uno dei fagioli magici, e alcuni XML ha mostrato sullo schermo?
Sono andato alla guida in linea per CardSpace. Ho pensato, "questa è la documentazione scritta specificamente per utenti non tecnici. Sicuramente questo spiegherà a me l'intero punto di questa cosa di CardSpace."
Beh, almeno che la documentazione era un pochino meglio. La guida in linea mi ha detto che CardSpace è "un sistema per la creazione di rapporti con siti e servizi Web".
Che non suona come qualcosa che volevo. Non voglio una relazione con un sito Web. Ho voluto visitare la CNN e leggere il giorno top stories.
A quel punto, ho rinunciato a tutto. Mi sono reso conto che una cosa è se il tuo gestione superiore non può spiegare il tuo progetto. È un'altra cosa interamente quando tu stesso non può spiegare la natura del proprio progetto.
Per essere onesti, il team di CardSpace è stato istituito dal loro ambiente. Il prodotto è stato progettato per e vissuto nel mondo dell'identità digitale. Una proprietà comune del mondo identità digitale è che nessuno è in grado di descrivere quello che fanno senza ricorrere a parole d'ordine. Più a lungo si passa il tempo in un mondo dove tutti parlano di un certo modo, più si assume che tutti parlano in questo modo, anche se è solo le persone nella vostra piccola cricca che parlare in questo modo.
È necessario avere la consapevolezza di sé per rendersi conto che stai facendo questo errore e Mettetevi nei panni di qualcuno che non ha trascorso gli ultimi anni parlando di gergo peculiare del tuo campo. Solo quando colmare il divario tra insider e outsider si può dire che tu hai è riuscito a comunicare.
.jpg)
Raymond Chendi Web site, The Old New Thing e identicamente intitolato libro (Addison-Wesley, 2007) trattare con la storia di Windows, programmazione Win32 e rischi per la sicurezza posati dal fastidiosi MIDI file.