Curs2

Comunicare despecialitateComunicare tehnica

Comunicare tehnica scrisa

Cum–tehnici/strategii

elaboraredocumente

Ce –modele/tipuridocumente

Ea s-arătă săltând şi se opriPrivind în jur c-un fel de teamă,Şi nările-i subţiri înfiorară apaCu cercuri lunecoase de aramă.

Sticlea în ochii-i umezi ceva nelămurit,

Ştiam că va muri şi c-o s-o doară.Mi se părea că retrăiesc un mitCu fata prefăcută-n căprioară.De sus, lumina palidă, lunară,Cernea pe blana-i caldă flori stinse de

cireş.Vai, cum doream ca pentru-ntâia oarăBătaia puştii tatii să dea greş!

Căprioara este un mamiferrumegător ce aparține familiei Cervidae. Caprioara este cea maimicaspeciedecapre salbaticeoriginare dinEuropa.Masculii autendinta deafi mai mari si mairobusti,incomparatie cufemelele.Masculul poartadenumirea decaprior,iar femeladecaprioara sau ciuta.Blana estediferita infunctie desezon.Iarna,blana este mai deasa,mai lunga,dand animalului unaspectciufulit,neingrijit,avand culoarecenusie sau maro-cenusiu…

•Personala/subiectiva• Expresiva•Ambigua

•Permite mai multeinterpretari

•Impersonala/obiectiva• Descriptiva•Sens unic

•Permite osingurainterpretare

Caracteristici – comunicare tehnica

1. Rezultatul unui specialist careintelege subiectul2. Concentrat pe subiect,nupe autor3. Claritate - permite unsingur inteles4. Mesaj – este construit infunctie denecesitatile

audientei5. Nivelul tehnic trebuie sa fieinteles decatre

audienta6. Eficienta si usurinta incitire

Focus

• Careeste scopul documentului?• Careeste subiectul?• Cineciteste documentul?• Catdemult stie cititorul despre subiect?• Ce stil trebuie sa aiba documentul?

Cum?

• Proces in5pasi importanti:– Determinarea scopului si audientei– Colectarea deinformatii– Organizarea si structurarea informatiei– Scriere primaversiune– Revizuire si editare

1. Determinarea scopului si audientei

• Scop:– Informare– Intelegere detalii– Promovarea unei actiuni– Comercial;publicitate/vanzare

• Audienta:– Intelegere– Interes

MDAistheapproachdevelopedbyOMGtoMDE.ItdefinesPIMusinga

DSL.

2. Colectarea de informatii

• Prin interactiune directcuclientul:– QA– Chestionar

• Surse scrise:– Folosirea dereferinte bibliografice !!!

• Citate• Citari “Nebunia:sa faci acelasi lucru mereu si sa

astepti rezultate diferite.”AlbertEinstein

Definitie:Uncompilator este unprogramcaretransforma unprogramsursa inprogramobiect [1]

[1]S.Motogna – Metode deproiectare acompilatoarelor,Ed.Albastra,2006,pag.6

Citari - cont

• Important!– toate informatiile pentruregasirea sursei bibliografice

• Exista standarde (AMS,IEEE)• Informatica:

– Referintele inordine alfabetica– Paragraf dedicat:Referinte bibliografice

(nunotedesubsol)

Citari - cont• Carti:autor,titlu,editura,anaparitie,pagini (daca ecazul)

Mellor,S.J.andM.J.Balcer,“ExecutableUML:AFoundationforModel-DrivenArchitecture,”AddisonWesley,2002.

• Reviste:autor,titlu,[inforevista:nume,nr.,volum,an],paginiLazar,I.,B.Parv,S.Motogna,I.-G.Czibula andC.-L.Lazar,AnAgileMDAApproachforExecutableUMLStructuredActivities,Studia Univ.Babes-Bolyai 1,LII(2007),pp.101–114.

• Volum editat +proceedingconferinta:autor,titlu,[infovolum:editori,titlu,anaparitie],paginiS.Motogna,B.PÂRV,I.Lazăr- AnMDAApproachforDevelopingExecutableUMLComponents,inErikaAsnina,JanisOsis(eds),Model-DrivenDomainAnalysisandSoftwareDevelopment:ArchitecturesandFunctions,IGI-GlobalInternational,2011,487p.,ISBN1-61692-874-3,pp254-273,

• Pagini web: autor,titlu articol (daca exista),url,dataaccesariiModelDriven Org.,“FoundationalUMLReferenceImplementation,”2008,http://portal.modeldriven.org/project/foundationalUML,accesat 8oct.2009

3.Organizare si structurare

• Organizare:– Cronologic– Cauza-efect– General-particular– Comparatie

• Document– structura:– Capitole– Paragrafe/sectiuni– Subsectiuni+exemple,figuri,tabele - numerotare

4.Primaversiune

• Recomandare:ABC

ØAbstract:descrie subiectul comunicarii - sumarØBody:partea cea mai consistenta – detaliiØConclusion:sumarizeaza prezentarea

5.Revizuire si editare

• Revizuire – reorganizare• Editare:

– Stil– Gramatica– Context

Alte aspecte

• Intelegere text:– Folosirea eficienta acuvintelor:vocabular– Folosirea eficienta apropozitiilor– “firrosu”– coeziune

• Stil:– Persoana a3-a– Persoana 1plural– Timpul verbelor– Punctuatie

CE- Tipuri dedocumente

• Documentatii• Rapoarte tehnice:

– Eseu/prezentare– Lucrare delicenta

• Manuale deutilizare• Articol stiintific• CV

Documentatii

• Proiect – depinde de:– Aplicatie – dimensiune,caracteristici– Roluri– Persoane– Task-uri– …

• Inteleasa detoti cei implicati=>pattern-uri,standarde,…

Exemplu

• http://epf.eclipse.org/wikis/openup/Guidance->Templates

Documente incluse

• Viziune deansamblu - fis• Planproiect – fis• Planpe iteratii – fis• Cazuri deutilizare (use-cases)– fis• Testare - fis

Rapoarte tehnice

• KISS– keepitshortandsimple(scurt si simplu)

• Recitire – detectare/corectare greseli• Respectare format• Daca nuesuficient delung?

– Documentare inplus

Format– raport tehnic

• Titlu/pagina titlu• Sumar – abstract• Cuprins• Introducere• Sectiuni – continut• Concluzii• Referinte bibliografice• Anexe

Introducere

• Context• Unenunt clar alscopului

– Prezentare rezultate cercetare,investigare,analiza,studiu comparativ

• Unenunt clar alobiectivelor• Cadru tehnic/stiintific necesar intelegeriiraportului

• Scurta descriere astructurii

Sectiuni

• Ordine logica asectiunilor• Prezentarea sa fiecontinua,fluenta• Titluri scurte si sugestive• Folosire:

– Figuri,tabele– Exemple– Liste cuitem-uri sau numerotate

Concluzii

• Relativ laobiectivele proiectului enuntate inintroducere – reliefarea rezultatelor esentialealeraportului

• Contine:– Afirma daca obiectivele aufost atinse– Sumar scurt alinformatiei cheie dinraport– Pune inevidenta beneficiile si semnificatia lor –evaluare/comparare

Anexe

• Informatie careeste prea detaliata pentru afiinclusa inraport

• Reguli:– Fiecare anexa areunnumar si untitlu– Fiecare anexa trebuie referita incontinut

Manuale deutilizare

• Cunoastere buna aprodusului/aplicatiei• Structura:

– Introducere:ce ofera– “gettingstarted”:

• Cerinte hardware/software• Setup/configurare

– Indicatii:folosire debaza/avansata– Caracteristici speciale– Rezolvarea problemelor/erorilor

Quiz

• Descriere curs:– Subiect– Obiective– Rezultat