Qual è l'accordo con i file di aiuto in questi giorni?

Question

Ho aggiunto this question at SuperUser per la prospettiva dell'utente.

Così creo un'applicazione in Delphi o .NET che verrà eseguita su un sistema desktop. Qualche bella interfaccia grafica con tutti i tipi di funzionalità e funzionalità. Funziona bene, i test mi dicono che è quasi privo di bug e sto per distribuirlo ...

ASPETTARE! Ha bisogno di un file di aiuto, in modo che gli utenti possano richiamare l'aiuto sensibile al contesto dall'applicazione!

Oppure no? I file di aiuto sono davvero un requisito per le applicazioni desktop in questi giorni? E hanno davvero bisogno di essere sensibili al contesto, tenendo le mani dell'utente per dire loro che devono riempire il loro giorno di nascita in questo campo etichettato "Giorno della nascita"? O gli helpfile stanno diventando un po 'antiquati?

Questo è qualcosa che mi chiedo e questo è un po 'soggettivo, quindi invece ho intenzione di chiedere qualcosa di diverso, a tutti voi che sviluppate applicazioni desktop: Offrite (ancora) file di aiuto sensibili al contesto?

Sì, o no, per favore. Sentiti libero di aggiungere alcuni testi soggettivi, ma per me è importante sapere se gli sviluppatori moderni stanno ancora aggiungendo un aiuto sensibile al contesto alle loro applicazioni GUI.

(Btw, io stesso ho spostato in file non contesto PDF che possono essere stampati come manuale. E 'molto più facile da mantenere.)

Answer 1

Sì, lo so.

Motivo: Non mi aspetto che l'utente sappia come funziona il programma. Ok, descrivendo ciò che deve essere inputed in un campo "giorno della nascita" è un po 'extrem, ma c'è roba normalmente più complesso in un sistema software. Ho dovuto scrivere un file di aiuto per il nostro sistema di contabilità dei costi proprio oggi, che descrive come il sistema di determinazione del prezzo che dovrebbe essere utilizzato per i lavori di calcolo. Non penso che nessun utente possa sapere come configurare il sistema senza questo file di aiuto.

Answer 2

al momento non, ma noi non scrivere molto di app di Windows. La maggior parte sono basati sul web. La maggior parte delle nostre app per Windows sono piuttosto piccole e ben documentate al di fuori di un file della Guida.

Inoltre, abbiamo gli utenti finali che scrivono la documentazione durante il processo di sviluppo, quindi la documentazione è qualcosa che capiranno.

Tuttavia, se scrivessi un'app di grandi dimensioni per molti utenti (non un'app interna) includerei un file di guida sensibile al contesto. L'ho fatto in passato per alcune delle nostre app più grandi e, in una situazione non interna, è molto utile.

Attualmente stiamo progettando il nostro sito Web per disporre di una funzionalità di "need help" sensibile al contesto e la funzionalità è stata ben accolta. Lo stiamo incorporando in tutto il nostro sviluppo web ora, sia per il nostro sito Web aziendale che per quello interno.

Answer 3

ho mai fornito aiuto sensibile al contesto in un'applicazione, né ho visto realizzato abbastanza bene in qualsiasi altra applicazione per utilizzare mai da solo. Secondo me, lo sforzo richiesto per farlo bene supera il beneficio.

Nell'ultima applicazione in cui sono stata coinvolta questa decisione, nell'applicazione sono stati utilizzati i fumetti di suggerimenti, che visualizzavano un fumetto quando l'utente passava su ciascun controllo. Abbiamo anche fornito un manuale convenzionale che era per lo più dettagliato con molti screenshot passo-passo.

Dopo un po 'gli utenti si sono ammalati dei palloncini e li hanno disattivati ​​con una casella di controllo che abbiamo fornito, ma sembrava aiutare i principianti a iniziare.

Answer 4

Ti do un parere personale, non supportato da nessun altro fatto che il mio gusto personale.

Scrivere file di aiuto è stato utile in passato, dove tutto era nuovo e le risorse online erano scarse. Oggi, la maggior parte degli utenti di computer apprende tramite esplorazione diretta. L'aiuto contestuale sotto forma di tooltip è grande e fortemente incoraggiato: dà suggerimenti per questo apprendimento esplorativo.

E la documentazione della guida con molti collegamenti per fare clic in giro? beh è apparentemente fantastico, ma usato molto di rado credo. Nella maggior parte dei casi l'utente può ottenere risposte con una ricerca google corretta. Inoltre, questo tipo di documentazione è costoso. Non può essere scritto da uno sviluppatore. Devi assumere o assegnare persone specifiche per questo, con la scrittura tecnica e la chiarezza come abilità rilevanti.

Se dovessi gestire questa decisione, fornirei documenti completi solo per quelle funzionalità che sono molto esoteriche e speciali (direi uniche) per la tua applicazione. In ogni caso, tenderei ad un tutorial online, invece dei file di aiuto contestuali. Questo ha il vantaggio aggiuntivo di fornire informazioni su quanto sia difficile utilizzare la tua applicazione e quali sono gli hotspot più richiesti (valutando gli hit e le query di ricerca dei referrer nei tuoi documenti online).

Answer 5

In un'applicazione recente, non è stata fornita una guida sensibile al contesto. Questo ha avuto motivi tecnici piuttosto che altro (il file di aiuto è, in sostanza, un file docbook multi-lingua, che in teoria supporta l'aiuto sensibile al contesto, ma non ha funzionato bene). Ha una pagina per ogni finestra/finestra di dialogo nell'applicazione, con tutti i controlli spiegati. Tuttavia, ogni controllo ha anche un tooltip abbastanza completo, che rimuove principalmente la necessità di ulteriore aiuto. Ogni finestra di dialogo ha un pulsante di aiuto per visualizzare la pagina specifica per la finestra di dialogo. Storicamente, è possibile memorizzare il testo del suggerimento nel file della guida, ma non sembra funzionare con i sistemi di guida recenti. E sono comunque immagazzinati in risorse.

Ma poi, non è un'applicazione per tutti. Poiché il sistema di rete che può essere gestito con l'applicazione è di per sé un argomento complesso, esiste comunque una formazione specifica per gli utenti e l'applicazione è stata progettata in modo tale che se si conosce il sistema di rete, si conosce anche l'applicazione. In altre parole, il modello dell'applicazione si allinea così bene con il modello utente che non sono necessarie funzionalità di guida complete. Questo dovrebbe essere l'obiettivo di qualsiasi sviluppo di applicazioni.

La maggior parte delle informazioni nei file della guida sui controlli non è molto più di ciò che è già presente nel tooltip, perché nessuno ha bisogno di più.

Office e Visual Studio hanno risolto il problema in modo piuttosto simile: premendo l'aiuto si apre la pagina della guida per l'intera finestra di dialogo, non per il singolo controllo.

Se si dispone di una parte di una finestra di dialogo così complicata da richiedere ulteriori spiegazioni (e dato che non è possibile riprogettarlo per renderlo più semplice), è possibile posizionare la spiegazione accanto al controllo. Questo è utilizzato in molte applicazioni per casi speciali, in modo che il flusso di lavoro non venga interrotto perché l'utente deve cercare, ad es. come deve essere scritto un testo specifico.

Answer 6

Parlare come utente, non come sviluppatore: sì, voglio un file di guida sensibile al contesto.

Ad esempio, attualmente sto valutando i controlli di terze parti da includere in un nuovo progetto. I controlli che hanno un buon aiuto sensibile al contesto (es.è possibile selezionare una proprietà nella finestra delle proprietà o una parola chiave nel codice e premere F1 per andare direttamente all'argomento della guida) sono molto, molto più facili da imparare e da usare.

Answer 7

Tutte le nostre applicazioni dispongono di una guida sensibile al contesto sotto forma di suggerimenti (simili ai suggerimenti di Office 2007) per tutte le funzionalità critiche dell'applicazione.

Anche se non offriamo il tradizionale file di aiuto in piena regola, abbiamo sicuramente una Knowledge Base che aggiorniamo regolarmente. Questa è una raccolta di tutto l'aiuto fornito ai clienti via telefono, e-mail, ecc., Su qualsiasi e tutti i problemi, opportunamente categorizzati e facilmente ricercabili. Questo alla fine finisce per essere il miglior aiuto che contiene più o meno ciò che i clienti cercano piuttosto che cosa noi inizialmente pensiamo possano aver bisogno.

Mentre pochi clienti invariabilmente finiscono per contattarci senza nemmeno dare un'occhiata alla Knowledge Base, ci aiuta ancora a reinventare la ruota più e più volte.

Answer 8

Con i tooltip e una capacità del computer generalmente maggiore negli utenti, alcune applicazioni funzionano bene senza file di aiuto. Tuttavia, alcune applicazioni necessitano di file di aiuto, sia per informazioni generali sull'argomento che per l'utilizzo dell'applicazione. Ad esempio, in un'applicazione fotografica potresti voler spiegare la compressione jpeg e includere alcuni esempi nel file della guida, anche se l'operazione dell'utente è evidente.

Mi sembra che Microsoft contribuisca al declino nell'aiuto sensibile al contesto, nel bene e nel male. In primo luogo, i sistemi di aiuto in Visual Studio sono, per usare un eufemismo, un dolore da usare. In secondo luogo, la facilità d'uso del sistema di guida di Visual Studio è diminuita in modo significativo. Ometterò lo sproloquio, ma basti dire che ci vogliono molti più clic e scorre per ottenere informazioni rilevanti nella guida VS2008. Questo tende a stabilire uno standard più basso per i sistemi di guida nelle applicazioni.

Answer 9

Nessun aiuto? Questo va bene per le persone che sono tecnicamente inclini e piace giocare con il nuovo software. Ma se il tuo software verrà utilizzato da persone che non sono esperti di tecnologia, l'aiuto è essenziale. Prendi il tuo esempio di date. Se hai un mercato internazionale, è meglio precisare di cosa ha bisogno il programma. Gli americani usano il formato MM/GG/AAAA, ma la maggior parte degli utenti internazionali usa GG/MM/AAAA; hai bisogno di precisare di cosa ha bisogno il programma.

Ho lavorato con molti sviluppatori che non avevano assolutamente idea dei loro utenti finali e del loro funzionamento. Ad esempio, un CTO che ha insistito sulla sua nuova azienda dovrebbe eliminare la documentazione stampabile senza sapere che i propri clienti hanno stampato tutti i PDF e la maggior parte degli argomenti della guida ogni volta che si verificava un aggiornamento. Devi conoscere il tuo utente finale e il tuo mercato. Sfortunatamente, troppi sviluppatori vivono in una bolla, circondati da altri sviluppatori.

Gli sviluppatori devono scrivere aiuto? Probabilmente no. A meno che non si possa davvero pensare come il tipico utente finale, si redigeri delle note, ma si lasci che un autore tecnologico rompa le informazioni tecniche fino al livello richiesto dall'utilizzatore finale.