Título : B1 INTRODUÇÃO Conteúdo : INTRODUÇÃO O termo documentação tornou se um conceito básico nos negócios, na administração, na ciência e na tecnologia da informação. A modelagem nada mais é que uma forma de documentar com detalhes os passos da geração de um sistema. 1.1 Documentação importante Atualmente, o documento é aparentemente mais importante do que aquilo sobre o que ele trata. Neste sentido, pode se considerar o caso das instituições e autoridades governamentais, em que uma pessoa somente existe se houver documentos que certifi quem esse fato. Uma pessoa sem documentos não possui uma identidade oficial. Da mesma forma, nas corporações, embora um contrato comercial que cria um vínculo legal possa ser estabelecido com um aperto de mãos, a prática comum é colocar os termos desse contrato no papel. Todos os dias, milhões de transações em todo o mundo são acompanhadas de documentos, eletrônicos ou não, podendo ser notas fiscais, pedidos de compras, faturas, recibos e assim por diante. Os documentos também são importantes para comunicar resultados científicos entre cientistas e o estudo científico, além do trabalho experimental e do estudo de campo. A reputação de um cientista é medida pelo número de documentos publicados e pela frequência com que é citado nos documentos produzidos por outros cientistas. Isto é importante para os projetistas de sistemas de documentação: quanto mais fácil for fazer referência cruzada em um sistema, maior é a possibilidade de ele ser adotado pela comunidade científica. 1.2 Histórico do sistema Observando o processo de desenvolvimento de um sistema por meio de uma visão de alto nível, percebemos que ele possui uma estrutura específi ca (Figura 1). Este processo se dá de forma iterativa e incremental, no qual o sistema ou o software não é implementado em um instante no fim do projeto, mas é, ao contrário, desenvolvido e implementado em etapas. A fase de construção consiste de várias iterações, em que cada iteração constrói software de qualidade de produção, testado e integrado, que satisfaz um subconjunto de requisitos de projeto. Cada iteração contém todas as fases usuais do ciclo de vida da análise, do projeto, da implementação e do teste. 1/5
As duas primeiras fases são a análise e o projeto. Durante a análise, estabelece se a lógica do domínio da aplicação para o projeto e decide se o escopo do projeto. No projeto, são coletados os requisitos mais detalhados para se estabelecer uma arquitetura básica e criar um plano para a construção do sistema. Os projetos variam de acordo com o volume de formalidade que eles possuem. Projetos de muita formalidade têm muitos documentos formais a ser entregues, reuniões formais, encerramentos formais. Projetos de pouca formalidade podem ter uma fase de concepção que consiste de um bate papo de uma hora com o patrocinador do projeto e um plano que cabe em uma folha de papel. Naturalmente, quanto maior o projeto, maior formalidade é necessária. A implementação elabora o sistema em uma série de iterações. Cada iteração é um novo miniprojeto, com casos de uso designados para cada iteração. Você termina a iteração com uma demonstração para o usuário e realiza testes de sistema na fase seguinte para confi rmar que os casos de uso foram construídos corretamente. O objetivo deste processo é reduzir o risco. O risco, geralmente, aparece porque casos difíceis são deixados para o fim do projeto. As iterações dentro da implementação são tanto incrementais quanto iterativas. As iterações são incrementais na função. Cada iteração é construída sobre os casos de uso desenvolvidos nas iterações prévias. As iterações são iterativas em termos da base de código. Cada iteração implicará que alguns trechos de código existentes sejam reescritos para torná los mais flexíveis. O teste e a integração são tarefas extensas, e elas sempre demoram mais do que as pessoas imaginam. Deixadas para o fim, elas são difíceis e desanimadoras. Os testes visam identificar quaisquer possíveis erros de construção ou conceito antes que o aplicativo seja disponibilizado para o usuário. Essa fase é de fundamental importância para a confiança do software, pois aplicativos que apresentam muitos erros e interferem no desempenho de seus usuários tendem a ter uma pequena aderência e uma vida curta. 1.3 Sistemas complexos A documentação tornou se o centro da infraestrutura de grandes sistemas de TI não apenas porque a autoria, o gerenciamento e a recuperação de documentos são áreas de aplicação importantes, mas também porque os componentes de software estão se tornando cada vez mais complexos. Nos primórdios da computação, na programação com Assembler (Figura 2) ou Fortran, as sub rotinas eram construções bastante simples que podiam ser facilmente controladas com parâmetros igualmente simples: inteiros simples, números de ponto flutuante, strings e endereços. 2/5
Nos dias atuais, os componentes reutilizáveis de softwares podem ser módulos enormes e bastante complexos, normalmente apoiados por interfaces repletas de recursos, o que tornou o entendimento dos sistemas modernos uma atividade altamente complexa. Por exemplo, um serviço Web. O protocolo de um serviço Web é descrito com uma linguagem chamada WSDL (Web Service Description Language), e a sintaxe das mensagens passada para um serviço Web pode ser descrita com a linguagem XML (Quadro 1), inicialmente chamada SOAP (Simple Object Access Protocol). 3/5
1.4 A documentação na Antiguidade Utilizando padrões de documento, o setor de TI pode aproveitar quase nove mil anos da experiência humana. O conceito de documentação está totalmente relacionado ao propósito do desenvolvimento da representação gráfica de elementos que possam resgatar a fatos passados. O advento dos sistemas de escrita remonta há nove mil anos e provavelmente coincidiu com a transição das sociedades de caça e coleta para sociedades mais agrárias. As evidências dos sistemas de escrita apareceram primeiramente em pedras entalhadas, utilizadas como símbolos de contagem, provavelmente usadas para contar certas propriedades, como animais ou medidas 4/5
de grão (Figura 3). Entre 4.100 e 3.800 a.c., na cultura suméria, na Mesopotâmia (atual Iraque), surgiu a escrita baseada em pictogramas. Ao final do quarto milênio a.c., a cultura egípcia desenvolveu o conceito de som. Pictogramas hieróglifos representavam as sílabas. Os hieróglifos (Figura 4), porém, representavam apenas as consoantes, não as vogais. Eles eram utilizados para representar o primeiro som da palavra representada pelo pictograma, um conceito chamado acrofonia. O mesmo conceito pode ser encontrado na escrita fenícia, que influenciou a escrita hebraica, aramaica e grega. Já em 800 a.c., os gregos foram os primeiros a representar as vogais com letras (Figura 5), sendo os precursores do alfabeto romano, no qual boa parte dos países latinos baseou o seu alfabeto.. 5/5