Soddisfare

  1. Ruolo dei manuali nello sviluppo di software
  2. Debunking il mito di XP del codice � documentazione
  3. Valore supplementare di buona documentazione
  4. Ruolo dei produttori tecnici nel progetto di XP
  5. Sommario


Ruolo dei manuali nello sviluppo di software
Stavo leggendo un articolo interessante da Ron Jeffries sull'emissione dei manuali. Sono in disaccordo con i suoi presupposti su varie funzioni. In questo articolo daremo un'occhiata al ruolo dei manuali nello sviluppo di software. Ma in primo luogo lascia per vedere che cosa deve dire su questo soggetto:

  • Tutto che abbia fatto di prodotto software sa che quasi nessuno legge il manuale. Conosciamo questo dalle domande che del supporto tecnico otteniamo. Lo conosciamo perch� la maggior parte di noi non leggono i manuali neanche.
  • I apps di fotoricettore non vengono con i manuali e stanno dando dei calci all'estremit�. Alcuni di loro hanno una coppia di pagine di aiuto. Molti non hanno niente ma le istruzioni alla pagina ed il flusso dei tasti.
  • Sempre pi� il software oggi � trasportato su un CD e l'unico manuale che ottenete � il formato della scatola CD. Sembra funzionarlo benissimo - la scienza ha trovato che pi� gente legga quei piccoli libri - ha pensato che stiano cercando le liriche.
  • E hey: I progetti di XP sviluppano il software con l'pi� alto valore di affari in primo luogo. Il roba all'estremit� non importa tanto quanto il roba all'inizio!

I manuali non sono definitivamente necessari per un tipo semplicistico applicazione Web del carrello di acquisto, n� sono hanno avuto bisogno di per molte altre tali applicazioni semplicistiche. Tuttavia dire che quasi nessuno legge il manuale � il pi� lontano dalla verit� poich� pu� essere. Per tutta l'impresa moderatamente complessa classifichi le applicazioni (Siebel, Oracle, SalesForce, rapporto di spesa di Extensity e gazillion altri) che richiedono l'interazione significativa dell'utente ed esprimono la logica complessa di affari, leggenti il manuale � obbligatorio se non volete scompigliare in su nel senso principale.

Non tutte le domande possono essere fatte cos� semplice quanto a non richiedere un manuale. La logica di fondo di affari determina il grado di complessit� dell'applicazione. Il suo articolo sembra messo a fuoco sulle piccole applicazioni semplicistiche soltanto.

Parecchi applicazione Web che ho lavorato con e sviluppato viene con l'insieme completo dei manuali. Provi a generare le applicazioni di bioinformatica del complesso (non appena una ricerca semplice come NCBI) senza un manuale.

Il resto delle discussioni contro un manuale rispettabile � politico-discorso-tipo senza molta logica. Cos� non passerei il tempo di confutarle punto per punto tranne quello finale.

> e hey: I progetti di XP sviluppano il software con l'pi� alto valore di affari in primo luogo. Il roba all'estremit� non importa tanto quanto il roba all'inizio!

L'pi� alto valore buono di affari per la maggior parte delle applicazioni di impresa comprende rendere il software comprensibile a tutti nei termini semplici liberi e quello richiede una buona documentazione libera.

La realt� al suolo � che i buoni manuali sono un forte requisito della maggior parte delle applicazioni di impresa.

Debunking il mito di XP del codice � documentazione
Il codice � la documentazione (mantra di XP) non lo taglia nel mondo reale. I clienti purtroppo non possono leggere questa parte fine del codice denominato documentazione. Gli sviluppatori dei diavoli neppure non possono leggere facilmente una certa tale documentazione.

Esaminiamo questo problema da un angolo differente. Possiamo fare il codice siamo documentazione una realt� appena per gli sviluppatori essi stessi?

Pagine: 1 2