Newsgroup: it.lavoro.informatica
Titolo: Documentazione tecnica

Vorrei capire se e quanti di voi lavorano o hanno lavorato in aziende in cui 
questo tipo di documentazione viene richiesta e mantenuta aggiornata per i 
progetti software su cui si lavora.
Personalmente provengo da una piccola azienda nella quale mi sono sempre 
lamentato della totale inesistenza di tale documentazione, con la 
conseguenza che capitava molto spesso di modificare qualcosa o di integrare 
alcune funzioni nel sistema già esistente e di accorgersi dopo la consegna 
che queste modifiche andavano ad influire su qualcos'altro di non previsto. 
La classica cosa che "sistemi  una cosa e ne rompi altre tre". Difficile 
senza un'adeguata documentazione ricordarsi "a memoria" tutti gli oggetti e 
le parti di software condivise e le loro influenze su quelle già esistenti, 
soprattutto quando il sistema è molto grande e complesso.
Pensavo fosse un problema appunto della piccola realtà presso cui lavoravo, 
invece ultimamente ho fatto una serie di colloqui presso aziende anche molto 
grandi, tra cui uno dei principali gruppi assicurativi italiani, e mi sono 
sentito chiedere prima se avevo conoscenze di UML e poi, su mia richiesta 
specifica, sentirmi ammettere che in ogni caso non è importante perchè non 
c'è mai il tempo materiale per creare una vera e propria documentazione 
tecnica, al massimo qualche flow chart che poi non viene comunque mai 
aggiornato. Wow!
Quindi, in caso accettassi uno di questi incarichi dove una delle attività 
principali sarebbe appunto la manutenzione/integrazione dei sistemi 
esistenti, mi ritroverei nella stessa situazione assurda di dover mettere le 
mani su un sistema gigantesco senza ben sapere come è strutturato se non 
chiedendo a tizio o a caio, i quali sicuramente si dimenticherebbero di 
darmi qualche particolare perduto nei meandri della loro memoria, con tutte 
le ovvie conseguenze del caso.
Ripeto, pensavo fosse una deficenza della piccola azienda presso cui 
lavoravo, invece mi ritrovo nella stessa situazione con realtà mastodontiche 
e relativi sistemi informativi proporzionati alle loro dimensioni.
Vorrei capire se sono io che per ironia della sorte finisco ad avere 
contatti solo con aziende mal organizzate o se è una situazione tipicamente 
italiana che si ripete spesso.
Ciao
F.

 tipicamente italiana che si ripete spesso.
La realta` italiana che conosco non ha idea di cosa siano i test
funzionali e la documentazione tecnica, essendo inutile per lo
sviluppo, e` pressoche` lasciata dimenticata (il che non e` neanche
cosi` tremendo anche se rende la vita piu` difficile ai novellini).
Non esiste davvero nulla di piu` utile dei test funzionali ma in
italia vengono visti come una perdita di tempoin moltissime grosse
aziende.
 
-- 
I'm using an evaluation license of nemo since 32 days.
You should really try it!
http://www.malcom-mac.com/nemo

 aziende.
Senza appunto contare il discorso dei passaggi di consegna ai "novellini", 
come hai detto tu, che diventa una perdita di tempo forse anche più grande 
rispetto a quello dedicato alla stesura della documentazione, soprattutto in 
caso di turn over elevato.
Insomma sostanzialmente mi trovo pienamente d'accordo con chi diceva che il 
tempo risparmiato per lo sviluppo (e per sviluppo intendo anche 
documentazione e test) è inversamente proporzionale al tempo impiegato per 
la successiva manutenzione.
Ciao
F. 


Ma i test funzionali senza la loro documentazione a cosa servono?? :-)
In sostanza non credo che usando *solo* i test ( poi cosa? I sorgenti
dei
programmi/unità di test? Gli input? Gli output?) si possa capire cosa
fa
un sistema complesso.

  un sistema complesso.
L'hai mai fatto? Oppure scrivi l'UML anche dei test? <g>. Io ho
imparato fior di sistemi complessi basandomi solo sui test funzionali
e scrivendo i test si capisce davvero come funziona un sistema perche`
la risposta a un tentativo di utilizzo arriva subito, se hai capito
luce verde, se non hai capito luce rossa.



Bravo, ma non è questa la mia esperienza.
Sfido qualcuno a capire cosa fa un sistema complesso vedendo, per
esempio, che in input entrano
certi numeri, ed in output ottieni un altro numero. E' la somma? La
differenza?
E' risultato di una scelta condizionale? Boh! Se qualcuno non te lo
dice o scrive...
Qui non ci riferiamo a fare i test mentre un'altro modifica il
sistema, qui il sistema
lo devi modificare tu od io!
Magari se parliamo di test con debug forse sono un poco più d'accordo
con te.
Ma dover capire un sistema *solo* con il debug è veramente
deprimente.... Altro che
ingegneria del software! :-)

  ingegneria del software! :-)
I test sono i test. E se l'ingegneria del software e` quella che si
paragona agli architetti che costruiscono grattacieli allora ben
vengail debug. 


 e relativi sistemi informativi proporzionati alle loro dimensioni.
Beh mi pare ovvio ;)
-- 
Lawrence, 
oluyede.org
 - 
neropercaso.it
"It is difficult to get a man to understand 
something when his salary depends on not
understanding it" - Upton Sinclair

 italiana che si ripete spesso.
Mi sa che tu lavori da poco....
Ciao,
Marco.
Guarda l'immagine cliccando 
http://attach.mynl.it/img?id=NjMyNw
-- 
questo articolo e` stato inviato via web dal servizio gratuito 
http://www.newsland.it/news
 segnala gli abusi ad 
ab...@newsland.it

 puoi applicare a progetti informatici.
è roba vecchia. Realizzare un buon software è un processo ARTIGIANALE, come
realizzare un buon armadio e un buon lampadario di vetro. I software che
hanno fatto 'storia' non sono stupidaggine che si portano alle spalle
migliaia di ingegneri del software che non sanno programmare ma
semplicemente 2 o 3 bravi artigiani in uno scantinato qualsiasi. Poi è
venuta la new economy, i laureati in ingegneria che non sanno programmare
ecc ecc

 F.
ciao Nicoal
--------------------------------
Inviato via 
http://arianna.libero.it/usenet/

 aziende.
concordo, preferirei leggere di piu' sui test funzionali che non i soliti
articoli sull'ennesima prova del processore a 333Ghz uscito da Intel o
l'ennesimo firewall con porte wifi ed estensioni per la protezione della
chiaroveggenza, che di solito infestano le veramente molto numerose riviste
di informatica italiane...