Domande con tag 'documentation'

domande con tag
5
risposte

Si basa molto sull'intelligenza e sulla documentazione mentre la codifica ti rende un programmatore cattivo? [duplicare]

È richiesto un programmatore per imparare e memorizzare tutta la sintassi, oppure è opportuno tenere a portata di mano qualche documentazione? Potrebbe influire sul modo in cui i manager considerano i programmatori? Quali sono i lati neg...
posta 13.06.2013 - 20:14
7
risposte

In quale fase dello sviluppo dovrebbero essere scritti i commenti?

Sono uno studente che sta facendo uno stage in un'azienda più grande, scrivendo app per piccole imprese in C #. Ho notato che non commento il mio codice mentre lo scrivo. Piuttosto, commento il mio codice quando sono nella fase di sviluppo del d...
posta 19.11.2012 - 19:54
5
risposte

Input della funzione di debug rispetto agli utenti in attesa del codice per leggere la documentazione - Quanto lontano posso andare? [duplicare]

Potrei scrivere una quantità infinita di codice di debug per gestire i vari componenti di input per una funzione, controllare che vengano utilizzati i tipi di dati corretti, assicurarsi che le cose siano discendenti degli oggetti prototipo cor...
posta 22.09.2015 - 14:52
5
risposte

Come assicurarsi che il codice sorgente dell'applicazione abbia una documentazione adeguata per i nuovi programmatori? [duplicare]

Sai come la grande azienda IT come IBM, Microsoft o Google si assicura che il loro codice sorgente dell'applicazione abbia una documentazione adeguata per i futuri nuovi programmatori? Quali sono i loro metodi o tecniche? Dicono ai programma...
posta 28.05.2012 - 08:40
4
risposte

È considerata una cattiva pratica documentare formalmente il codice di implementazione?

PEP-8 indica chiaramente quali parti del tuo codice devono avere documentazione: Write docstrings for all public modules, functions, classes, and methods. Docstrings are not necessary for non-public methods, but you should have a comment...
posta 13.05.2017 - 04:10
4
risposte

È utile avere autori tecnici in un team di software?

Durante i miei 5 anni in IT come sviluppatore di software, ho notato che gli sviluppatori hanno una strong avversione nei confronti della documentazione. L'atto di prendere screenshot e creare documentazione sembra essere un'esperienza dolorosa...
posta 02.03.2011 - 01:22
5
risposte

La documentazione dovrebbe essere una politica aziendale o la responsabilità di ogni programmatore? [chiuso]

Ultimamente ho lottato con l'intero argomento della documentazione nella mia attuale posizione. Sono ad un punto della mia carriera di programmatore in cui sento di essere appena nato nel mondo intero di una documentazione corretta ed efficace....
posta 25.03.2011 - 03:21
4
risposte

Quanta documentazione dovrebbe aspettarsi un cliente da un team individuale? [chiuso]

Lavoro per una piccola azienda di elettronica e supporto software che ha appena concluso un contratto con una grande azienda che è molto severa in materia di documentazione (io faccio il software di supporto, essenzialmente applicazioni Windows...
posta 29.07.2011 - 04:46
5
risposte

Statistiche sulla percentuale media di tempo richiesta per creare documentazione "utilizzabile"

AGGIORNAMENTO: ho ricevuto molti feedback, ma nessuna informazione su quale percentuale di tempo le persone spendono per i documenti. Per semplificare, dì che i documenti sono per sviluppatori e peer review; il che significa che il peer comprend...
posta 25.01.2011 - 13:59
2
risposte

Qual è una buona lunghezza per Javadoc per una classe che è lunga 800 righe?

Sto facendo una revisione del codice sul codice di qualcuno per classe. La classe è lunga circa 800 righe, contiene una dozzina di funzioni ma la descrizione è lunga 1 riga. Mi chiedo, in generale, per quanto tempo dovrebbe essere la descr...
posta 26.11.2012 - 01:32