[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[linux_var] R: Re: Testo per scrittura specifiche tecniche
- To: <jacopogg83@gmail.com>, linux_var - LUG di Varese e Provincia Mailing List <talking@ml.linuxvar.it>
- Subject: [linux_var] R: Re: Testo per scrittura specifiche tecniche
- From: "giorusconi@libero.it" <giorusconi@libero.it>
- Date: Mon, 30 Dec 2013 11:42:35 +0100 (CET)
- Dkim-signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ml.linuxvar.it; s=mail; t=1388400177; bh=W4MBUQNm+39X5TRJIGgRSTVdjXN1slFt3qv16HRXIZ8=; h=Date:From:To:MIME-Version:Subject:Reply-To:List-Id: List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe: Content-Type:Content-Transfer-Encoding:Sender; z=Received:=20from=20outrelay02.libero.it=20(outrelay02.libero.it=2 0[212.52.84.102])=0D=0A=09by=20linuxvar.it=20(Postfix)=20with=20ES MTP=20id=2000CD83C315A=0D=0A=09for=20<talking@ml.linuxvar.it>=3B=2 0Mon,=2030=20Dec=202013=2011:42:35=20+0100=20(CET)|X-CTCH-Spam:=20 Unknown|X-CTCH-RefID:=20str=3D0001.0A0C0205.52C14E1B.0073,ss=3D1,r e=3D0.000,fgs=3D0|X-libjamoibt:=201587|Received:=20from=20wmail61= 20(172.31.0.58)=20by=20outrelay02.libero.it=20(8.5.140.03)=0D=0A=0 9id=2052B85B6100702342=3B=20Mon,=2030=20Dec=202013=2011:42:35=20+0 100|Date:=20Mon,=2030=20Dec=202013=2011:42:35=20+0100=20(CET)|From :=20"giorusconi@libero.it"=20<giorusconi@libero.it>|To:=20<jacopog g83@gmail.com>,=20linux_var=20-=20LUG=20di=20Varese=20e=20Provinci a=20Mailing=20List=0D=0A=09<talking@ml.linuxvar.it>|MIME-Version:= 201.0|X-SenderIP:=2081.114.145.37|X-libjamv:=209ATW9L4jxok=3D|X-li bjamsun:=20BlGHTQn+qPGT0+F71W7iyLr/ouYxi/dg|Subject:=20[linux_var] =20R:=20Re:=20=20Testo=20per=20scrittura=20specifiche=20tecniche|X -BeenThere:=20talking@ml.linuxvar.it|X-Mailman-Version:=202.1.13|P recedence:=20list|Reply-To:=20"giorusconi@libero.it"=20<giorusconi @libero.it>,=0D=0A=09linux_var=20-=20LUG=20di=20Varese=20e=20Provi ncia=20Mailing=20List=0D=0A=09<talking@ml.linuxvar.it>|List-Id:=20 linux_var=20-=20LUG=20di=20Varese=20e=20Provincia=20Mailing=20List =0D=0A=09<talking.ml.linuxvar.it>|List-Unsubscribe:=20<http://ml.l inuxvar.it/cgi-bin/mailman/options/talking>,=0D=0A=09<mailto:talki ng-request@ml.linuxvar.it?subject=3Dunsubscribe>|List-Archive:=20< http://ml.linuxvar.it/pipermail/talking>|List-Post:=20<mailto:talk ing@ml.linuxvar.it>|List-Help:=20<mailto:talking-request@ml.linuxv ar.it?subject=3Dhelp>|List-Subscribe:=20<http://ml.linuxvar.it/cgi -bin/mailman/listinfo/talking>,=0D=0A=09<mailto:talking-request@ml .linuxvar.it?subject=3Dsubscribe>|Content-Type:=20text/plain=3B=20 charset=3D"iso-8859-1"|Content-Transfer-Encoding:=20quoted-printab le|Sender:=20talking-bounces@ml.linuxvar.it|Errors-To:=20talking-b ounces@ml.linuxvar.it; b=IYd+KGe+asImgNH4M4Gp0ftDQI8GYowSC2ggpl2KB2c6z7OLG+OzmO9I5XcrmQYsG p1Lk1WOAknMDbnKkBXUtO0jFff1GeQaCxqUbJmBZ1MhQNCangmnSdiphMCgs5VuxwT jeiNd5gKKfX2D3NXLwh1GBA5ZMUXncvYT5HaRU0k=
- List-archive: <http://ml.linuxvar.it/pipermail/talking>
- List-help: <mailto:talking-request@ml.linuxvar.it?subject=help>
- List-id: linux_var - LUG di Varese e Provincia Mailing List <talking.ml.linuxvar.it>
- List-post: <mailto:talking@ml.linuxvar.it>
- List-subscribe: <http://ml.linuxvar.it/cgi-bin/mailman/listinfo/talking>, <mailto:talking-request@ml.linuxvar.it?subject=subscribe>
- List-unsubscribe: <http://ml.linuxvar.it/cgi-bin/mailman/options/talking>, <mailto:talking-request@ml.linuxvar.it?subject=unsubscribe>
- Reply-to: "giorusconi@libero.it" <giorusconi@libero.it>, linux_var - LUG di Varese e Provincia Mailing List <talking@ml.linuxvar.it>
- Sender: talking-bounces@ml.linuxvar.it
>Da: jacopogg83@gmail.com
>Data: 29/12/2013 15.57
>Innanzitutto una domanda: questo lavoro di documentazione servirà in futuro a
>qualcuno? Servirà a qualcun'altro eccetto te? Ha valore per l'azienda?
La documentazione ha valore per l'azienda che è assolutamente concorde nel
farla. Non mi ci devo insomma dedicare a tempo perso. In teoria dovrà servire
come riferimento a me o a chiunque in futuro dovesse mettere mano
all'applicazione.
>Per il resto, che genere di manualistica devi scrivere, devi documentare
delle
>API per dei programmatori o delle funzioni per degli utenti finali? Qualche
Sicuramente dovrà aver un taglio tecnico (come se fossero specifiche da
passare a degli sviluppatori): gli utenti conoscono l'applicazione meglio di
me.
>manuale l'avrai letto, quindi un'idea anche vaga di come scriverlo potresti
>averla. Descrivere lo scopo dell'applicativo, le sezioni in cui è diviso, le
Il problema è passare dalla teoria alla pratica. Alcuni spunti interessanti li
ho
trovati in "Working effectively with legacy software", ma quel testo affronta
il
problema tramite unit test che non sono possibili nel RAD usato in azienda e
sono comunque un passo successivo a quanto devo fare ora. In effetti il mio
problema è più nel campo del software "legacy" che non in quello della
documentazione.
http://www.objectmentor.
com/resources/articles/WorkingEffectivelyWithLegacyCode.pdf
_______________________________________________
Talking mailing list
Talking@ml.linuxvar.it
http://ml.linuxvar.it/cgi-bin/mailman/listinfo/talking