Está en la página 1de 2

EstructurarInformes

IngenieradelSoftwareII
FacultaddeCiencias
Febrero2010
4IngenieraInformtica
UniversidaddeCantabria

CMOESTRUCTURARUNINFORMETCNICOCOMOUN
VERDADEROINGENIERO

1. Introduccin
Elpresentedocumentocontieneunabrevedescripcinacercadecmoestructuraruninforme
tcnicoycmoredactarlaintroduccindelmismoconelrigor,laprecisinylacalidadquese
lesuponeaunIngenieroSoftware.
2. Estructuradeuninformetcnico.
Uninformetcnicosuelepresentar,salvocircunstanciasadicionales,lasiguienteestructura:
(1) Resumen.Nomsde200palabrasdescribiendoelcontenidodeltrabajo.
(2) Introduccin.Nomsdede2pginasdetallandombito,objetivosyresultadosdel
trabajo.
(3) Contenido. Tantas secciones como hagan falta para explicar los contenidos tcnicos
deltrabajo.Sevalorarcapacidaddesntesis,precisinenelusodellenguaje,facilidad
de seguimiento de la exposicin y completitud. Se valorar especialmente que todas
las secciones se encuentren perfectamente ligadas, tengan un objetivo claro y cada
prrafoenellascontenidosirvaparaelcumplimientodedichoobjetivo.
(4) Conclusiones. Debe resumir los puntos fundamentales del trabajo y servir de sntesis
deltrabajoaaquellapersonainteresadaeneltrabajo.
(5) ApndiceMetodologa.Especialmenterelevanteentrabajosacadmicosoinformes
tcnicos de investigacin donde sea necesario evaluar el proceso seguido para la
elaboracin del mismo de cara a evaluar la veracidad, validez y calidad de su
contenido.Enestaseccinsedebedescribirdeformabreveperocompletaelproceso
seguido para la elaboracin del trabajo Se suele valorar principalmente que se haya
seguido un proceso sistmico y/o cientfico. Debern citarse todas las fuentes
consultadas,tantolasdescartadascomolasusadasparalaelaboracindeltrabajo,as
comolaraznparadichaaceptacinorechazo.
3. Redactarunaintroduccinparauninformetcnico.
Laintroduccindecualquierdocumentoeslapartemsdelicadadelmismo.Laintroducciny
el resumen son lo primero que se leen, y de su calidad depender que captemos al lector y
contineconlalecturadelmismo.Inclusoenelcasodondeellectorestobligadoacontinuar
con la lectura del documento, una buena introduccin ayudar a que el lector realice dicha
lecturaconintersyatencin;ynoporsimplecompromisodemanerasuperficial.
Por tanto, en una introduccin debemos cautivar al lector. Para ello, suele dar resultados
seguirunesquemacomoelqueseesbozaacontinuacin:
(1) Descripcindelmbitodeldocumento.Definicionesgenerales.Porejemplo,siel
informeessobreunanuevatcnicadegestindecostosenproyectossoftware,
deberamosempezardiciendoLagestindecostesenproyectos(software)tratade

EstructurarInformes
IngenieradelSoftwareII
FacultaddeCiencias
Febrero2010
4IngenieraInformtica
UniversidaddeCantabria

estimardeformalomsprecisaposibleelcostetotaldeproduccindeunsistema
software.
(2) Para qu es relevante dicho mbito. Por qu debera el lector seguir leyendo sobre
dichombito.Sesuelenproporcionarejemplosycitarfuentesqueconfirmequeesos
ejemplos no son inventados. Por ejemplo, Se ha identificado que las mayores
prdidas econmicas en proyectos software en os ltimos aos tienen su origen en
estimaciones imprecisas y/o demasiado optimistas del coste de proyectos software
(Fulano&Mengano,2008).
(3) Sobre qu parte de este mbito trata este documento en concreto. Centramos el
mbitodenuestrodocumento.Porejemplo,Elpresenteinformedescribeunatcnica
derecienteaparicinparalaestimacindeproyectossoftwaredentrodeldominiode
laspajarerasylosasadoresdepollos.
(4) Cul es el objetivo de este documento. Si se trata de un artculo de investigacin, se
debe comentar claramente qu aspecto del estado actual hemos mejorado. Por
ejemplo,ladietapresentadaenesteartculocontribuyeareducirlacantidaddecido
lcticoacumuladotrasesfuerzosfsicosprolongados.Sisetratadeuninformetcnico,
normalmenteseresaltanlosmritosalcanzadosporotros.Porejemplo,latcnicade
estimacin de costes propuesta por Konigashi y Yakamura permite reducir la
incertidumbre existente en las tcnicas actuales de estimacin software en un 10%.
En ambos casos, en la seccin de conclusiones deberemos argumentar cmo se han
cubierto estos objetivos brevemente. Ejemplo para el primer caso: 100 personas
siguieron esta dieta, mientras que otras 100 personas no la siguieron. Ambos grupos
de personas fueron sometidos a diferentes esfuerzos fsicos prolongados. A
continuacin medimos la cantidad de acido lctico acumulado en cada grupo,
observando una reduccin media del 30% en aquellas personas que haba seguido la
dieta descrita en este documento. Ejemplo para el segundo caso: La tcnica de
Konigashi y Yakamura ha sido aplicada en diversos proyectos software con notable
xito. Merece especial mencin el caso de la pajarera Eulalio, donde el error en la
estimacin de costes fue inferior al 0.2%, mientras que usando las tcnicas
tradicionalesdichoerrorsehaestimadodeentreel5%yel15%.
(5) Breveresumendelprocedimientoseguidoparaelaborareltrabajo.Debedarconfianza
enqueelprocesoseguidoparalaelaboracindelinformehasidounprocesoserioylo
que se describe no es lo primero que se le ha ocurrido al autor o lo primero que ha
encontradoporinternet.
(6) Estructura del documento. Describe brevemente el contenido de cada seccin del
presenteinforme.LonormalesusarfrasescomoTrasestaintroduccin/EnAdelante,
este documento/informe se estructura como sigue/tal como se describe a
continuacin.

PabloSnchezBarreiro