Domande con tag 'documentation'

domande con tag
5
risposte

Determinazione della giusta quantità di documentazione

Dove lavoro attualmente l'approccio generale è - evita il più possibile la documentazione Documenta solo se un team diverso ne avrà bisogno solo per chiarimenti, non intendo la documentazione del codice - questo lo facciamo, intendo...
posta 02.02.2012 - 15:42
2
risposte

Lingua Ubiquitous - conflitto tra correttezza e usabilità

Una parte fondamentale del Domain Driven Design è l'uso coerente di un linguaggio ubiquitario attraverso il sistema: conversazioni, codice, schema del database, interfaccia utente, test, ecc. Sono coinvolto in un progetto in cui esiste già un...
posta 22.09.2011 - 22:08
1
risposta

Quali informazioni dovrebbero essere nel github README.md?

Quali informazioni ti aspetti di vedere nel github README? Tutto dovrebbe andare nel README? cioè. Introduzione Installazione Versioni Guida dell'utente Attuazione Test Risorse correlate O dovresti semplicemen...
posta 25.05.2013 - 11:10
5
risposte

Buoni riferimenti per gli esempi di documentazione per l'utente finale e consigli [chiuso]

Il nostro software interno è stato utilizzato da molti utenti e il dipartimento di formazione ci ha chiesto eventuali suggerimenti sul formato della documentazione per l'utente finale. Qualcuno sa dove posso trovare buoni esempi di documentaz...
posta 26.04.2011 - 12:51
5
risposte

Utilizzo di modelli diversi per funzionalità simili

Sono l'unico sviluppatore di un progetto che, come per qualsiasi progetto software, potrebbe essere preso da qualcun altro in futuro. Diciamo che ho usato lo schema X per implementare la funzione A. Dopo aver sviluppato e terminato la funzion...
posta 30.08.2016 - 14:37
7
risposte

Come posso documentare il lavoro passato di qualcun altro? [chiuso]

Siamo in una brutta situazione di scarsa documentazione sulla personalizzazione dei nostri dipendenti passati in un sistema aziendale critico. Sono state apportate numerose modifiche a Crystal Reports, entità di database e file di configurazione...
posta 24.02.2012 - 15:48
3
risposte

I commenti XML sono documenti necessari?

Ero un fan di richiedere commenti XML per la documentazione. Da allora ho cambiato idea per due motivi principali: Like good code, methods should be self-explanatory. In practice, most XML comments are useless noise that provide no addit...
posta 22.10.2012 - 16:16
7
risposte

Stili di documentazione per commenti / codici

Questa potrebbe essere una domanda stupida, ma è stata per un po 'nella mia testa e non riesco a trovare una risposta decente da nessun'altra parte. Ho un insegnante che dice che dovremmo elencare esplicitamente ogni parametro con una descriz...
posta 06.12.2010 - 19:15
7
risposte

In che modo i team di sviluppo software professionali affrontano la complessità del design in progetti non banali?

In primo luogo, mi rendo conto che questa domanda potrebbe essere alquanto lunga e vaga e mi scuso per questo. Questo è probabilmente un problema di base con un nome breve per chiunque abbia "capito", ma non trovandomi a questo riguardo, per fav...
posta 21.05.2012 - 02:39
13
risposte

Puoi scrivere una specifica non ambigua in un linguaggio naturale come l'inglese?

Mi sembra che non sia possibile scrivere una specifica del software in inglese che sia completamente priva di ambiguità, semplicemente a causa della natura informale del linguaggio naturale - e quindi che una specifica veramente non ambigua deve...
posta 08.09.2011 - 12:42