Home

Capítulo 05 - Divisão de Bibliotecas e Documentação PUC-Rio

1. o Digital N 0015561 CA 115 equipe de manuten o e desenvolvimento do mesmo deixando as quest es de ger ncia de fora Minha vis o como Webmaster e gerente do site est em grande parte expressa nas hip teses dessa disserta o e em sua justificativa Certamente a realiza o desse trabalho levou me a refletir profundamente sobre tudo que aqui foi visto de forma que minha vis o sobre o tema aqui tratado foi expandida e muito enriquecida No que se refere ao uso da documenta o para fins gerenciais eu complementaria afirmando que se pensarmos em um projeto de documenta o que sirva tamb m de apoio a ger ncia do site al m das informa es de controle dos processos de trabalhos que constam atualmente no manuel online devem ser incluidas informa es sobre as rotinas manuais ou externas ao sistema tais como armazenamento de correspond ncia e midia recebida procedimentos de ger ncia do servidor de ftp tempor rio modelos de cartas a serem enviadas aos usu rios controle de documentos n o virtuais fotos pastas correspond ncias internas disquetes CD s de back up etc Ao longo desse cap tulo apontei v rios estudos que podem ser desenvolvidos a partir dos resultados dessa pesquisa Entretanto mais dois desdobramentos podem ser sugeridos l J que as quest es de ger ncia do site foram propositalmente evitadas pelos motivos anteriormente descritos poderia se fazer um estudo que envolvesse tais quest es rel
2. o semelhante entretanto descrita de uma forma diferente Flavia Aucar Soler Designer alocada em fun es de Manuten o e Desenvolvimento do site Criar uma coisa que possa ser reproduzida uma receita de bolo Tem que pensar na facilidade e agiligade com que ele poderia ser alterado e a facilidade de nao ter que varrer o site para encontrar os lugares onde uma informa o que deve ser alterada ocorre A parte de funcionamento deve estar toda explicada Tem que pensar que ele pode crescer entao nao pode pensar em uma coisa muito fechada Utilizar recursos f ceis de atualizar como libraries includes etc Alan Lima Designer alocado em fun es de Desenvolvimento do site O Designer deve acompanhar todas as etapas do desenvolvimento desde o come o pois as quest es de Interface e Design podem ter tratadas junto a um usu rio antes que a parte t cnica de inform tica esteja fechada Assim as metodologias de Design e Inform tica caminham juntas Tem que ter controle tem que ter um meio que a manuten o seja feita rapidamente e sem falhas Deve se pensar em como o site ser atualizado ter o cuidado de guardar os arquivos originais Jo o Condack Analista de Sistemas alocado em fun es de Desenvolvimento do site ressaltou que se a manuten o pensada durante a constru o durante o projeto do site voc consegue reduzir o custo de 4 Library e Include s o recursos utilizados na co
3. o criativo no sentido PUC Rio Certifica o Digital N 0015561 CA 98 de m o na massa porque fazer alguma coisa a n vel de manuten o que seja criativa dificil N o tem muito no dia a dia O que pode acontecer que esse contato faz com que voc tenha depois uma criatividade em pensar algo que possa melhorar algo que voc veja todo dia e que n o esteja bom Nesse sentido eu acho criativo quando voc olha de fora aquilo que voc v e fala aqui pode melhorar e eu sei que pode melhorar dessa forma sei pela experiencia por estar em contato com aquilo todo dia Veja por exemplo a quest o dos emails a entrevistada respons vel por ler e responder mensagens enviadas pelo p blico do site muita coisa que a gente melhorou para esse site novo referindo se a vers o 2002 do site da PUC tamb m partiram disso de voc estar o tempo todo recebendo manuten o pedidos de atualiza o ou vendo a quantidade de emails que chegam reclamando de alguma coisa ou sugerindo alguma coisa ou perguntando onde estava determinada informa o no site fez com que a gente agisse de forma criativa pensassem em coisas novas Nesse sentido a manuten o algo criativo Ao responder sobre como ocorria seu processo de cria o a mesma entrevistada relatou Ocorre por for a do impacto mesmo Por exemplo tem coisas que vem a qualquer hora tem coisas que voc olha e pensa aqui podia ter isso sur
4. sendo mostrado O que est me facilitando o que poderia melhorar Quando falam Web Design para mim a pessoa que est por tr s disso est vinculada a Interface melhorar a Interface trabalhar com Interface para melhorar essa intera o Marcelo Hess Programador alocado em fun es de Manuten o e Desenvolvimento do site Web Design para mim est ligado a Interface e a Est tica Alan Lima Designer alocado em fun es de Desenvolvimento do site Existe Web Design como usu rios de computadores aqueles que sabem pelo menos o significado da palavra a diagrama o de uma p gina de um site na Internet Mas complicado falar o que Web Design porque uma coisa que surgiu do nada algu m um dia deu esse nome Alguem come ou a montar as p ginas HTML e quando come aram a inserir imagens come aram a ter preocupa o que aquela p gina tivesse diagrama o comunicasse melhor deram esse nome mas n o sei porque No meu ponto de vista algo t o importante quanto o conte do da p gina Porque n o adianta ter uma p gina que informa mas n o atraente para o usu rio A express o Web Designer me incomoda Para come ar porque americana e eu n o gosto muito Essas coisas de americanizar os nomes as pessoas acabam se apropriando Eu prefiro falar que sou Desenhista Industrial Antes quando eu preenchia formul rios eu sempre colocava Desenhista Industrial Agora existe n
5. Digital N 0015561 CA 111 ponto de vista de transmiss o da t cnica uma segmenta o de p blico algo que deve ser considerado 8 Para a Designer Flavia Aucar Soler um dos pap is do Designer em um projeto de constru o de um site o de ser um alavancador de id ias que for a a tecnologia a ir mais longe 5 11 Rela o documenta o do site sua ger ncia e processo de trabalho da equipe Atrav s dessa pesquisa verificou se que de fato no processo de trabalho da equipe de Desenvolvimento e Manuten o do Web site da PUC Rio sua documenta o uma ferramenta fundamental a qual todos os entrevistados declararam utilizar e recorrer como ferramenta de apoio para realiza o de suas tarefas e treinamento de novos membros da equipe servindo principalmente como uma esp cie de garantia para a realiza o r pida e correta das tarefas de manuten o do site Abaixo s o apresentados trechos extra dos das entrevistas que comprovam o papel essencial da documenta o nesses processos Jo o Condack Analista de Sistemas alocado em fun es de Desenvolvimento do site Se tenho que substituir algu m da equipe primeiro vejo qual a manuten o que tem que ser feita se tiver alguma documenta o ou alguma fonte de como se fazer vou consultar Soraya Atan zio Analista de Sistemas alocada em fun es de Manuten o do site a importancia da documenta o nesse processo a
6. atualiza o espec ficas de cada rea ou seja instru es espec ficas de como alterar a imagem de como alterar a programa o existente por tr s dela etc Conforme sugerido pelo Designer Alan Lima poderia se ter tr s vis es de um elemento uma completa e geral uma sob o ponto de vista do Design e outra sob o ponto de vista de seus aspectos de Inform tica Alan atribuiu ao Designer por ser um profissional com uma voca o interdisciplinar a responsabilidade de projetar a documenta o de um site j que parte de sua tarefa entender o uso do produto do ponto de vista do usu rio o que n o o deixaria esquecer as necessidades de todos os usu rios tanto da rea de Design quanto de Informatica que estivessem envolvidos no uso dessa documenta o 6 No que diz respeito documenta o da Navega o a Analista de Sistemas Soraya Atan zio alocada em fun es de Manuten o do site sugeriu uma representa o visual que simulasse que mostrasse a estrutura e que voc pudesse navegar nessa estrutura de forma din mica que viajasse com voc pela estrutura A entrevistada acha que deveria existir uma metodologia pr pria para documentar sites Falta unificar universalizar independente do tipo do site algo que me diga como eu vou documentar aquilo que estou falando imagem fonte texto programa o 7 Em uma equipe de manuten o como a do site da PUC Rio com fun es bem definidas
7. citados no par grafo anterior o c digo do programa escrito em Linguagem de Programa o e a formaliza o do problema s o tamb m considerados formas de representa o da informa o Por parte dos profissionais de Design e Inform tica alocados em tarefas manuten o foi registrada uma preocupa o com o uso em documenta o textual de termos t cnicos espec ficos de uma rea Recomendou se evitar vocabul rios fechados ou explic los Soraya Atan zio Analista de Sistemas alocada em fun es de Manuten o do site texto uma forma de comunica o que pode ser compreendida independente da rea gosto de receber documenta o nesse formato e acho que mais facil de entender por todos claro que pode ser complementada por elementos graficos Minha primeira procupa o com as palavras bom evitar vocabul rios fechados s de uma rea ou explic los por mais que pare am bvios Exemplo se estou documentando e tenho que usar o termo download Procuro explicar mais download buscar o arquivo em tal lugar copiar para tal lugar Da mesma forma a Fl via pode ler uma documenta o sobre o SAU online falando sobre JSP Ela j sabe o que e como faz para abrir mas pode vir um outro Designer para a equipe e precise substitui la e ele pode n o entender a documenta o A mesma coisa para template library O Daniel estagi rio quando entrou aqui perguntou o
8. de dar independ ncia da equipe n o depender de pessoas que conhe am como realizar a tarefa e garante minimizar os riscos minimizar os erros voc fazer r pido e sem errar No acumulo de fun es quando tenho que cobrir alg em que est de f rias o papel da documenta o fundamental porque d uma tranquilidade para realizar a tarefa Uso o manual para nao ter que decorar coisas como sintaxe da cria o de ponteiros ou de detalhes dos passos as pessoas de desenvolvimento n o usam muito o manual Muito dificil Mas as de Manuten o eu o Marcelo e o Daniel estagi rio de Inform tica usamos principalmente para manuten es n o muito frequentes onde voc esquece como se faz Marcelo Hess Programador alocado em fun es de Manuten o e Desenvolvimento do site Acho important ssimo documentar um site PUC Rio Certifica o Digital N 0015561 CA 112 Voc pode ter pessoas que vao vir a trabalhar no site futuramente Se nao tiver documenta ao ela vai levar muito mais tempo para entender do que se tiver uma coisa documentada registrada j mostrando como funciona como foi feito etc Sob o ponto de vista da manuten o se voc j tem uma coisa documentada s vezes voc faz uma coisa depois come a a fazer outras coisas e vai que voc tem que recorrer a coisas que j fez no passado claro que voc j esqueceu algum detalhe da constru o de um c digo de uma imagem e
9. de manuten o e desenvolvimento e profissionais de Inform tica e Design alocados em ambas as reas deve ser considerada a ado o de uma documenta o segmentada por p blico 17 O evento mouse over tamb m conhecido como roll over image permite que um evento seja disparado quando o usu rio passa com o mouse em cima de uma imagem A implementa o mais comum desse recurso a troca da imagem por outra ao qual tamb m normalmente associa se um elo link com outra p gina PUC Rio Certifica o Digital N 0015561 CA 110 alvo onde por exemplo a documenta o de cada elemento do site pode conter uma vis o geral do mesmo acompanhada de uma divis o por rea Design e Inform tica De acordo com Hackos 1994 existem diferen as na forma como as pessoas entendem informa es alguns precisam de menos detalhes enquanto outros precisam de mais Alguns encontram a informa o mais facilmente usando um tipo de Design enquanto outros s o mais produtivos utilizando um outro completamente diferente Alguns trabalham melhor com mais informa es gr ficas enquanto outros trabalham melhor com mais informa es textuais A Designer Flavia Aucar Soler alocada em fun es de Manuten o e Desenvolvimento do site observou que os programadores se apegam muito a formaliza o de id ias em um plano l gico quase matem tico tendendo a partir o problema em v rios peda os enquanto o Designer tende a olha
10. entrevistados da rea de Inform tica ela adotada e fielmente seguida pela equipe A atual documenta o do site reserva inclusive se es a respeito desse t pico Observei que esse procedimento um facilitador do processo de manuten o pois permite encontrar e substituir facilmente os arquivos que comp em o site o que agiliza muito as tarefas de manuten o e a transmiss o dos padr es utilizados no site a membros novos da equipe Dentre as observa es feitas pelos entrevistados a respeito de m todos ou metodologias de gera o atualiza o da documenta o as seguintes podem ajudar PUC Rio Certifica o Digital N 0015561 CA 94 a estabelecer par metros e at normas a serem observados em um projeto de documenta o de um Web site 1 A manuten o de um site deve ser encarada como um projeto tanto quanto sua constru o onde a documenta o gerada seria um de seus produtos A documenta o de um site deve ser gerada juntamente com o processo de desenvolvimento do mesmo e sua atualiza o tamb m deve ser realizada simultaneamente a atualiza o do site Em casos de extrema press o ou pressa deve ser feito logo ap s o t rmino da tarefa como sendo parte da mesma atualizar a documenta o Emergiu tamb m o fato de que esse passo em uma documenta o seria perfeitamente possivel mesmo em ambientes de grande press o conforme citada por Marcelo Hess Programador alocado em fun es de Manut
11. es de fronteira entre Design e Inform tica Na an lise das respostas obtidas verificou se que quase todos os entrevistados associaram o termo Web Design ao termo Interface embora algumas defini es tenham envolvidos quest es ligadas Est tica Comunica o Intera o e Design da Aplica o sob o ponto de vista da Inform tica conforme pode ser visto a seguir Jo o Condack Analista de Sistemas alocado em fun es de Desenvolvimento do site O termo envolve v rias reas Web Design na rea de Engenharia voc estaria preocupado em fazer o design da intera o da sua aplica o com o usu rio Web design da rea Gr fica como voc organiza a informa o graficamente em termos de layout em termos da organiza o visual da informa o em determinado espa o em caso de uma tela especificamente na Web uma tela de browser Soraya Atan zio Analista de Sistemas O termo Aplica o em Inform tica refere se a programa de computador software PUC Rio Certifica o Digital N 0015561 CA 79 alocada em fun es de Manuten o do site Web Design tudo que tem a ver com a Interface Internet pessoa Tudo que voc pode fazer em rela o a Interface Quando digo interface me refiro mais a Interface gr fica visual do que aquela intera o do que vai acontecer quando eu clico Mas sim o que eu vejo como est a diagrama o ou como aquilo est sendo disponibilizado como est
12. ncias essa mais til aos cargos de ger ncia do site rela es entre as p ginas para que possa manter controle sobre os v nculos links ou elos entre as mesmas No que diz respeito atualiza o da documenta o todos os entrevistados foram un nimes a respeito da necessidade de uma forma autom tica de atualiza o ou gera o da documenta o o que sem d vida garantiria a consist ncia dos documentos como uma forma de representa o que corresponda fielmente ao site documentado PUC Rio Certifica o Digital N 0015561 CA 90 5 5 Processos m todos de trabalho padroniza es de representa o de nomes etc uso de metodologia Qualquer enfoque metodol gico ou m todos de trabalho aplicados a gera o e atualiza o da documenta o de um Web site devem levar em conta que para a mesma venha a servir como ferramenta de apoio as tarefas de ger ncia e manuten o do site ela deve ser projetada de maneira que sua forma de utiliza o e ou disponibiliza o considere que os fatores tempo e velocidade s o cruciais em Internet conforme citado pelos entrevistados Soraya Atan zio Analista de Sistemas alocada em fun es de Manuten o do site Em Manuten o e Internet o mais importante quanto mais r pido O que voc puder fazer para estar atualizado e o mais r pido poss vel j que quando voc come a a atualizar significa que a coisa j est desatualizada Isso caract
13. o aprofundamento no caso do site da PUC Rio permitiu me explorar uma situa o espec fica mas com muitas caracter sticas comuns a outros sites Embora o site da PUC Rio possua se es com menor frequ ncia de atualiza o tais como as p ginas Mensagem do Reitor e Hist ria e Missao o mesmo como um todo recebe solicita es de atualiza o diariamente e v rias vezes ao dia Conforme dito anteriormente outros estudos poder o verificar a adequa o a outros casos espec ficos a partir dos resultados aqui obtidos importante acrescentar que muitas pesquisas das reas de Inform tica e Documenta o relacionadas a Web caminham com vis o complementar s quest es aqui apresentadas Entende se que com a pr tica e experi ncia de uma equipe de manuten o a documenta o tende a ser utilizada com menos frequ ncia Entretanto se a equipe pequena e com muitas atualiza es agendadas em dias fixos outras antecipadamente agendadas e outras sob demanda a documenta o assume um papel fundamental nesse processo servindo n o s como o reposit rio do como fazer mas tamb m de quando e servindo a equipe como um documento comum de trabalho organiza o e treinamento Por volta de trinta anos atr s a rea de Design buscava o estabelecimento de padr es t cnicos de aplica o de marcas logotipos e s mbolos hoje amplamente utilizados na produ o de manuais de Identidade Corporativa No que
14. o pudesse ir ouvindo o que tem que fazer e ir abrindo janelas como um Wizard mas mais inteligente Ex o audio sairia dizendo para atualizar essa imagem abra o Photshop e o sistema dispararia o programa Um documenta o MULTIM DIA uma forma r pida de documentar falando e r pido tamb m entender a documenta o ouvindo Alan Lima Designer alocado em fun es de Desenvolvimento do site tem coisas que voc n o pode descrever graficamente Tem que narrar Cabe ressaltar que a utiliza o de instru es passo a passo textuais ou atrav s de recursos multim dia foi citada por todos Sobre formatos de documenta o surgiram muitas men es a manuais talvez em fun o da equipe estar acostumada a trabalhar com um A Analista de Sistemas Soraya Atan zio e o Designer Alan Lima declararam que em alguns casos espec ficos a exist ncia de uma documenta o impressa agiliza e facilita seu uso principalmente quando a tarefa a ser executada complexa e necessita de mais tempo para ser assimilidada Nesses casos poder imprim la para l la em casa ou t la a m o no momento de realiza o da tarefa para a marca o a l pis de pontos a serem destacados pode vir a acelerar bastante a realiza o da tarefa Considerando se que uma documenta o impressa poderia vir a ficar obsoleta com muita rapidez o mais recomendado que sejam disponibilizados recursos de impress o da documenta
15. que include As vezes voc conhece a palavra mas n o entende o sentido que ela est sendo utilizada ali A Designer Flavia Aucar Soler alocada em fun es de Manuten o e Desenvolvimento do site tamb m evidenciou a preocupa o em evitar termos t cnicos espec ficos de uma s rea que n o sejam acompanhados de explica o sobre seu significado no contexto em uso O uso de anima es na explica o da forma de realiza o de tarefas de manuten o tamb m foi citado pelos dois Designers entrevistados pelo Programador Marcelo Hess e pelo Analista de Sistemas Jo o Condack PUC Rio Certifica o Digital N 0015561 CA 82 Os Designers expressaram o desejo sobre a possibilidade de poderem seit go pie 5 11 E na ti Fe utilizar recursos multim dia no estilo dos Wizards dispon veis em v rios programas orientando passo a passo a realiza o de uma tarefa de manuten o A Designer Flavia Aucar Soler acredita que o uso de recursos que explorem v rios sentidos pode contribuir bastante no entendimento da documenta o e acelerar a realiza o da tarefa A atual documenta o do Web site da PUC Rio n o utiliza recursos de udio ou v deo em sua gera o ou disponibiliza o Flavia Aucar Soler Designer alocada em fun es de Manuten o e Desenvolvimento do site utilizar recursos multim dia Voc poder documentar falando ou ouvir a documenta o onde a pessoa que faz a manuten
16. I Re Formas de documenta o representa o Pr Processos metodos de trabalho padroniza es de representa o de nomes etc Fu Fun o que desempenha x vis o da liga o constru o do site gt manuten o Ab reas de fronteira sua abordagem e tratamento Ma rela o documenta o x ger ncia x processo de trabalho da equipe Ap s a transcri o das fitas e uma vez finalizada a an lise dos dados as categorias finais foram as seguintes sendo que foram identificadas categorias que aglomeravam ou sintetizavam quest es presentes em outras Wd Defini es sobre o que Web Design versus fun o que desempenha na equipe e rea de atua o Design ou Inform tica Re Formas de Documenta o Representa o Formatos Tecnologia envolvida na Documenta o Pr Processos m todos de trabalho padroniza es de representa o de nomes etc uso de metodologia Fu Fun o que desempenha versus vis o da liga o da constru o do site com sua manuten o Ab reas de fronteira e interse o entre Design e Inform tica sua abordagem e tratamento Ma Rela o documenta o do site sua ger ncia e processo de trabalho da equipe Us Quest es ligadas ao usu rio Categorias aglomeradoras CdMa Caracter sticas e Demandas do processo de Manuten o do site CdDe Caracter sticas e Demandas do projeto de Desenvolvimento do site Info Inform
17. Imagens tridimensionais esbo os desenvolvidos diretamente no computador storyboards simula o de funcionamento de tela no espa o s vezes construindo objetos com o uso de cola e papel antes de lev los ao bidimensional Embora os assuntos de fronteira entre Design e Inform tica presentes no processo de desenvolvimento e manuten o de um site e sua influ ncia no registro e documenta o do mesmo venham a ser tratados em um item mais a frente j na an lise das formas de representa o da informa o e formatos de documenta o foram identificadas sugest es id ias coment rios e pontos de vista que consideram e abrangem elementos de fronteira entre as reas de Design e Inform tica assim como poss veis formas de abordagem dos mesmos no processo de gera o da documenta o de um Web site Soraya Atan zio Analista de Sistemas alocada em fun es de Manuten o do site prefere um PUC Rio Certifica o Digital N 0015561 CA 84 formato de documenta o organizado por tarefas a serem realizadas onde no decorrer de uma explica o passo a passo seriam descritos os procedimentos da tarefa de manuten o Os elementos de Design ou Inform tica envolvidos na tarefa assim como as t cnicas a serem empregadas em sua manuten o seriam apresentados propor o que a informa o fosse necess ria para a realiza o de cada passo da tarefa Para a entrevistada o processo de manuten o de um sit
18. PUC Rio Certifica o Digital N 0015561 CA 75 5 Resultados O trabalho apresentado nessa disserta o partiu da hip tese de que Web sites s o projetos complexos que incorporam elementos de Design e de Inform tica para a disponibiliza o de conte do na World Wide Web e de que Web sites de grande porte institucionais ou n o que demandam atualiza o r pida di ria e organizada apresentam caracter sticas de projetos de Desenho Industrial onde necess ria a exist ncia de registros que tornem poss veis sua reprodu o e continua o Os resultados dessa pesquisa s o decorrentes da an lise dos dados levantados atrav s do estudo da documenta o do Web site da PUC Rio dos dados extra dos durante as entrevistas realizadas com a equipe de desenvolvimento e manuten o do mesmo e do cruzamento dessas informa es com o Referencial Te rico no qual baseou se esse trabalho As conversas informais com coordenadores de sites Designers e profissionais de Inform tica desenvolvedores da rea de Web tamb m forneceram importantes informa es complementares ao meu trabalho O aprofundamento da pesquisa no processo de gera o e uso da documenta o do Web site da PUC Rio permitiu me levantar e analisar dados e extrair recomenda es e conclus es a respeito de quest es metodol gicas formatos e formas de representa o da informa o envolvidas nesse processo bem como o uso da documenta o gerada como uma fer
19. Rio Certifica o Digital N 0015561 CA 91 Publica es na rea de Inform tica abordam aspectos metodol gicos relacionados ao fator tempo onde certos m todos de projetar incluem passos de forma a permitir que a solu o seja testada o mais cedo possivel atrav s de pequenos testes ou prot tipos Todos os entrevistados s o da opini o que o desenvolvimento de um Web site deve ser encarado como um projeto e acham que o uso de metodologia nesse processo fundamental que minimiza os riscos e possibilidade de ocorr ncia de erros no projeto Um aspecto que emergiu claramente nos resultados que a gera o da documenta o considerando se seu uso na manuten o do site deve ser encarada como um outro projeto Embora as metodologias de desenvolvimento de sistemas produzam documenta o e poderia se dizer que se bem empregadas deveriam gerar documenta o adequada ao uso pela equipe de manuten o ainda assim uma quest o que merece mais estudo pois existem aspectos caracteristicos do processo de manuten o que uma documenta o gerada a partir da metodologia de desenvolvimento pode vir a n o contemplar se n o considerar fatores do tipo a documenta o vai ser usada com frequ ncia e muitas vezes em situa o de extrema press o com curto tempo para a realiza o da tarefa devido a caracter stica de constante crescimento do site da PUC Rio a pr pria documenta o pode vir a ser atualizada com frequ ncia a d
20. Voc n o tem que fazer um outro projeto inteiro Voce muda alguns peda os e tem um projeto novo O equivalente a um desenho t cnico de um site mais complexo do que o de um outro produto Porque a parte da inform tica toda uma lista de c digos que faz ele funcionar E a parte de Design tem N imagens tem velocidade e para deixar ele mais r pido fa a isso ou fa a aquilo tem como salvar uma imagem para visualiza o mais r pida por exemplo um sapato eu n o vou salvar ou visualizar melhor ou pior dependendo de como eu salvar PUC Rio Certifica o Digital N 0015561 CA 100 5 7 Fun o que desempenha versus vis o da liga o da constru o do site com sua manuten o Os entrevistados alocados em fun es de manuten o demonstraram uma clara preocupa o com o impacto do projeto de desenvolvimento sobre o processo de manuten o do site Entretanto os dois Designers entrevistados um deles alocado tamb m em manuten o mostraram preocupa o semelhante No caso do pessoal de manuten o esta preocupa o bvia devida a suas experi ncias de terem como fun o principal receber para altera o produtos que n o foram constru dos por eles Quanto aos Designers tal preocupa o em parte deve se ao fato de terem uma forma o voltada a necessidade da transmiss o de t cnica para fins de reprodu o de um produto como o caso do curso de Desenho Industrial 5 8 Caracter sticas
21. a es que devem constar na documenta o e atualiza o da documenta o PUC Rio Certifica o Digital N 0015561 CA 78 Nos itens a seguir ser o apresentadas as conclus es extra das por categoria e tamb m aquelas extra das atrav s dos cruzamentos realizados entre algumas delas importante ressaltar que como um dos principais objetivos dessa pesquisa foi analisar o papel da documenta o no processo de manuten o do site muita aten o foi dada a esse aspecto e os resultados aqui divulgados s o frutos dos cruzamentos realizados luz do mesmo 5 2 Defini es sobre o que Web Design versus fun o que desempenha na equipe e rea de atua o Design ou Inform tica Essa categoria foi identificada com o objetivo de mapear as diversas vis es e entedimento dos entrevistados em rela o ao termo Web Design ao qual atualmente s o associados diferentes significados Aqui tamb m procurou se identificar se a defini o pessoal de cada entrevistado para o termo Web Design teria alguma rela o com a natureza da fun o que cada um desempenha na equipe desenvolvimento ou manuten o ou com sua rea de atua o Design ou Inform tica Embora a categoria em si n o tenha uma rela o t o direta com o tema tratado tanto quanto outras categorias que ser o apresentadas a seguir ela foi importante no mapeamento inicial dos pontos de vista dos entrevistados a respeito de um termo que pode remeter a quest
22. a o usu rio que solicitou a atualiza o A importancia da documenta o nesse processo a de dar independ ncia da equipe n o depender de pessoas que conhe am como realizar a tarefa e garante minimizar os riscos minimizar os erros voc fazer r pido e sem errar Eu acho que a manuten o de um site deve encarada da como um projeto um projeto de manuten o e parte dele cabe a quem desenvolveu que vai dizer o porque dele e como se altera Deve tamb m estar integrado ao site No que diz respeito aspectos metodol gicos relacionados a documenta o de um site os registros gerados pelo processo de desenvolvimento podem vir a n o serem adequados para fins de manuten o pois se considerar mos a documenta o de um site como uma ferramenta que deve servir de apoio s tarefas de manuten o do mesmo essa documenta o passa a ser resultado de um projeto de natureza diferente do site que a mesma representa apresentando caracter sticas de um sistema de informa o e de manual t cnico Ou seja mesmo PUC Rio Certifica o Digital N 0015561 CA 93 que a documenta o de um site seja resultado de um processo de desenvolvimento onde os passos de uma metodologia pr pria de desenvolvimento de sites s o fielmente seguidos ainda assim alguns novos documentos ou formatos talvez precisem ser acrescentados a essa documenta o ou a mesma ser implementada no formato de um sistema para que venha a servir adequadamente a
23. acionadas ao processo de atualiza o de informa es e cria o de novas p ginas A seguir s o listadas as principais informa es extra das a partir das entrevistas Jo o Condack Analista de Sistemas alocado em fun es de Desenvolvimento do site O que a manuten o significa para um site Tem manuten o corretiva quando tem algo errado e voc quer consertar e manuten o evolutiva quando voc quer fazer uma melhora em cima do que voc j tem e atualiza o quando voc tem algo que passou da data A atualiza o mais facil de ser automatizada Corretiva j nem tanto pois uma exce o que voc tem que tratar Como voc tem o compromisso de manter a informa o sempre atualizada o processo de manuten o pode vir a ser at o carro chefe do site Cuidados ao se criar uma p gina nova manter a identidade da area onde voc est colocando a p gina divulgar no sitte sobre a p gina checar se a inser o dessa p gina nao esta tornando outras p ginas obsoletas ou com necessidade de atualiza o PUC Rio Certifica o Digital N 0015561 CA 102 Soraya Atan zio Analista de Sistemas alocada em fun es de Manuten o do site Um projeto de um produto qualquer um sapato uma caneta qualquer coisa tem sempre uma garantia um tempo de validade Um sapato a n o ser que voc n o use voc sabe que n o vai ser para sempre a mesma coisa voc sabe que s vai durar um dete
24. acionando as tamb m aos processo de manuten o desenvolvimento e re design do site 2 Embora essaa disserta o tenha focado no estudo do caso do site da PUC Rio acredita se que seus resultados sejam tamb m v lidos para aplica o na gera o da documenta o de sites semelhantes sites institucionais ou n o que demandem atualiza o r pida di ria e organizada Entretanto seria necess rio um novo estudo como desdobramento deste para avaliar a total adequa o ou n o desses resultados a sites semelhantes Nesse caso recomendo prontamente a inclus o do gerente coordenador do site na lista de entrevistados Devem ser elaboradas quest es ligadas ger ncia bem como sua inclus o no roteiro das entrevistas As mesmas podem ser formuladas a partir das 18 O servidor de ftp tempor rio utilizado para transfer ncia de arquivos dos departamentos que possuem sites hospedados no servidor institucional do PUC PUC Rio Certifica o Digital N 0015561 CA 116 informa es que forne o nessa disserta o sob meu ponto de vista como gerente do site da PUC Rio Muitas delas encontram se no cap tulo de Metodologia dentro do item elabora o das hip testes Procurou se atrav s desse trabalho levantar o papel da documenta o bem como seus aspectos metodol gicos de formato e de uso no processo de desenvolvimento e manuten o de sites que demandam atualiza ao r pida di ria e organizada sendo que
25. ade ocorrem atrav s de elementos de Design viabilizados pela implementa o proporcionada pelos recursos de Inform tica Sob esse ponto de vista surgiram as seguintes sugest es de formas de document la a p gina poderia ser encarada como um elemento nico com seus aspectos e elementos de Design e Inform tica juntos ou insepar veis ou seja organizar a documenta o por p gina onde todas as t cnicas e normas relacionadas a atualiza o daquela p gina estariam documentadas separadas por Design e Inform tica dependendo do caso O Programador Marcelo Hess citou as Interfaces de Webmail utiliza o de servi os de correio eletr nico atrav s de p ginas Web como algo que s existe na Web onde tem aquelas caixas de escrever o texto de escrever o assunto para quem voc est mandando a mensagem tem aqueles bot es de apagar mensagem de selecionar mensagem enfim uma interface t pica de um site e onde n o se separa inform tica de Desenho Indutrial PUC Rio Certifica o Digital N 0015561 CA 109 4 Para fins de manuten o a documenta o poderia ser organizada por poss veis tarefas a serem executadas 5 Elementos gr ficos associados a funcionalidades de programa o tais 17 e imagens mapeadas como mouse over ou roll over image poderiam ser documentados de uma maneira integral pelo seu funcionamento onde o elemento como um todo seria explicado acompanhado das formas de
26. alhau porque n o tem um projeto de manuten o At a quest o da documenta o que a gente aqui insiste muito e tem o manual Nele voc tem um acervo um caminho um passo a passo um projetinho Quando voc vai fazer a manuten o de alguma coisa voc j tem aquilo estruturado Voc n o sai fazendo a manuten o de qualquer forma Porque eu posso fazer na m o o outro fazer no Dreamweaver o outro n o quer saber do template ou acha uma solu ao nova para resolver aquele problema que j est documentado j tem um CGI documentado Quando voc n o tem documentado como resolver aquele problema voc faz o que vem na cabe a na hora Seria muito importante acho que tem que partir mais para isso em ter um projeto de manuten o mesmo uma l gica de como essa manuten o feita Como as manuten es fixas que fazemos j tem uma l gica um hor rio todo mundo sabe como tem um ritmo etc E para os outros tipos de manuten o que fazemos Como agora estamos trabalhando muito mais com documenta o do que a gente trabalhava a uns tempos atras como isso faciltou para todo mundo nem est tudo mais no Felipe j foi um passo enorme Quando a gente n o tinha isso estruturado n o tinha isso documentado ent o ficava sempre na depend ncia Quando voc tem isso documentado quando voc tem isso estruturado quando tem um projeto qualquer pessoa que ler esse projeto e conseguir entender capaz de fazer
27. as listas inclusive da Receita Federal Inclusive Web Designer tamb m existe Flavia Aucar Soler Designer alocada em fun es de Manuten o e Desenvolvimento do site Sou Designer de Produto Fiz Desenho Industrial em Projeto de Produto Atualmente trabalho com Comunica o Visual fazendo o site da PUC O Design muito importante n o s na Web mas como em todas as coisas que a gente v Bem ou mal primeiro a gente se atrai pela beleza e depois a gente v o que est por tr s daquela beleza Ent o o que eu fa o hoje eu acho importante para atrair as pessoas a entrarem no site Web Design desenho de tela organizar a tela 5 3 Formas de Documenta o Representa o Formatos Tecnologia envolvidas na Documenta o Atrav s dessa categoria foi poss vel identificar as formas de representa o da informa o utilizadas para registro do processo de projeto e para transmiss o da t cnica para fins de realiza o de tarefas de manuten o do site Buscou se tamb m levantar recomenda es para formas de representa o comuns aos profissionais das reas de Design e Inform tica e de documenta o de elementos de um site cujos aspectos de cada uma das referidas reas est o intrinsecamente PUC Rio Certifica o Digital N 0015561 CA 80 ligados o que pode tornar dif cil o processo de documenta o ou a compreens o dos documentos tornar se confusa caso a rea de atua o de
28. ca t o intrinsecamente ligados como o caso de Web sites sendo que muitos deles como o caso do site da PUC Rio apresentam a caracter stica cr tica de demandarem uma atualiza o r pida di ria e organizada A seguir ser o apresentadas as conclus es s quais cheguei ap s a an lise dos dados bem como os resultados obtidos com o trabalho Foram identificados v rios poss veis desdobramentos de car ter interdisciplinar para essa pesquisa e acredita se que a mesma ofere a uma relevante contribui o para o preenchimento de lacunas existentes nas reas de conhecimento relacionadas a documenta o manuten o e ger ncia de Web sites em especial s que se referem s rela es existentes entre as reas de Design e Inform tica 5 1 Categorias e rela es identificadas Conforme detalhado no Cap tulo de Quest es Metodol gicas a an lise de dados levantados por essa pesquisa iniciou se formalmente durante a aplica o das entrevistas quando j fui relacionando categorias de informa o que iam emergindo A cada categoria inicialmente identificada foi associado um c digo para facilitar a aplica o de refer ncias s mesmas dentro dos relat rios de an lise O material da primeira fase de an lise anterior a transcri o das entrevistas pode ser visto no Anexo II A seguir est o listadas as categorias identificadas na etapa inicial da an lise PUC Rio Certifica o Digital N 0015561 CA T
29. de vir a precisar utilizar a documenta o do projeto do mesmo gerada e concebida pela equipe que o desenvolveu o segundo o usu rio ou vistante do site cujo acesso s informa es nele disponibilizadas dependem em grande parte do trabalho da equipe de manuten o O terceiro o usu rio que solicitou a equipe de manuten o uma altera o no site Alguns aspectos levantados durante as entrevistas est o relacionados a todos eles l Um sistema deve funcionar para o usu rio e o mesmo deve estar presente em todas as etapas do desenvolvimento que de alguma forma influenciar o a Interface para dizer os requisitos as tarefas que pretende PUC Rio Certifica o Digital N 0015561 CA 105 realizar atrav s do sistema e a forma como pretende realiz las conforme dito por Jo o Condack Analista de Sistemas alocado em fun es de Desenvolvimento so site 2 Uma tarefa de manuten o deve ser feita o mais r pido poss vel j que quando surge a necessidade da realiza o da mesma significa que o site ou sua documenta o j est o desatualizados Essa agilidade afeta a quantidade de tempo que o usu rio n o ter acesso a informa o atualizada 3 Na cria o de novas p ginas seja no site ou em um formato de documenta o online deve se ter o cuidado de manter a identidade da rea do site onde a p gina est sendo inserida e se a inser o da mesma n o est tornando outras p ginas obsoletas
30. diz respeito a rela o Web e Design ocorre no presente algo semelhante busca se padr es de transmiss o de t cnica e m todos de projeto e trabalho adequados a esse rec m nascido produto o Web site com sua vasta quantidade de elementos de Design e Inform tica intrisecamente ligados e onde muitos conceitos relacionados a ambas as reas situam se pr ximos a fronteiras repletas de interse es Portanto a grande contribui o dessa disserta o sem d vida preencher algumas das in meras lacunas existentes nas reas de PUC Rio Certifica o Digital N 0015561 CA 17 documenta o manuten o e ger ncia de sites principalmente se levarmos em conta o ainda pequeno n mero de publica es sobre o assunto
31. do pouca aten o principalmente no que refere se as quest es de Design que ainda est o sendo tratadas em grande parte com m todos e metologias importadas e adaptadas da rea de midia impressa combinadas com metodologias da rea de Inform tica Design uma rea relativamente nova e Web uma tecnologia praticamente rec m nascida se considerarmos seu tempo de exist ncia em rela o PUC Rio Certifica o Digital N 0015561 CA 114 a outras tecnologias baseadas em Tecnologia Computacional tais como Banco de Dados Computa o Gr fica Engenharia de Software etc S o portanto duas reas que quando relacionadas apresentam com muitas lacunas de conhecimento a serem preenchidas Os profissionais com atualmente maior tempo de experi ncia no desenvolvimento e ou ger ncia de projetos para a Web foram autodidatas e desenvolveram os primeiros m todos aplicados no desenvolvimento e manuten o de sites Somente mais recentemente que metodologias adequadas ao desenvolvimento de aplica es hiperm dia tais como a OOHDM passaram a ser utilizadas em uma escala um pouco maior mas ainda sim existem muitos sites funcionando atrav s da improvisa o de m todos de trabalho O site da PUC Rio assim como muitos outros que como ele surgiram nos prim rdios da Web e cresceram rapidamente foram seriamente afetados pelo boom da Internet e pelo r pido crescimento da Web em t o pouco espa o de tempo principalmente devido a fa
32. do site proporcionaria a equipe de manuten o uma ferramenta ligada ao mesmo Sanders 1998 identificou que embora as formas de documenta o dos elementos de um site se utilizem muito de termos emprestados do Design Gr fico das reas de publica o e do universo da m dia impressa percebeu que o Design de um site mais an logo rea de Arquitetura que tem o mais cl ssico PUC Rio Certifica o Digital N 0015561 CA 88 documento de Design o ante projeto ou a planta da constru o que representa fielmente o produto final Guias de estilo tendem a ser listas de regras e normas que podem vir a mostrar ao que est o se referindo mas cuja forma bem diferente do produto final A natureza visual de uma planta em um projeto de arquitetura significa que de fato representa a fisicalidade da estrutura na propor o de um para um ou seja essa linha aquela parede e essa linha aquela janela Acredito ser verdadeira essa analogia particularmente para sites que permitem a realiza o de tarefas em oposi o a sites baseados em disponibiliza o de conte do A afirma o de Sanders 1998 muito enriquecedora quando pensa se em um formato de documenta o de um site Entretanto cabe complementar que o uso de desenhos t cnicos ou formas de representa o semelhantes s usadas em arquitetura n o consideram a princ pio que o produto tenha uma natureza modific vel como o caso de um Web site c
33. e Intera o e Navega o s o elementos que residem nessa fronteira cheia de reas de interse o sendo que muitas s o as poss veis formas de document las N o houve um consenso entre os entrevistados das duas reas em rela o aos mesmos ou seja uns os consideraram elementos mais de Inform tica outros os consideraram dos dois No que diz respeito Navega o poder amos associ la a algo estrutural relacionando a a estrutura da informa o mas tamb m poder amos relacion la ao caminho a ser percorrido como um deslocamento no espa o que para melhor funcionar necessita de algo equivalente a um projeto de sinaliza o aspecto de Design A Interface e a Intera o com o usu rio apresentam aspectos das reas de Design e Inform tica e tamb m de outras reas tais como Ergonomia e Comunica o No entanto percebe se que muitos outros elementos de um site considerados pelo senso comum como sendo de uma determinada rea podem na verdade ser compreendidos de forma diferente pelos profissionais de Design e de Inform tica Um simples arquivo de imagem pode ser encarado como um conjunto de bytes organizados em um determinado padr o GIF ou JPEG por exemplo ou como a imagem que ele representa que por sua vez carrega uma mensagem Considerando todos os questinamentos apresentados aos entrevistados sobre os elementos de fronteira e interse o entre as reas de Design e Inform tica presentes em um W
34. e deve ser encarado com um projeto cujo produto resultante seria um manual online ou impresso ou algo ao qual a equipe pode recorrer como um registro de transmiss o da forma de constru o do site Acrescentou tamb m que na organiza o do processo de manuten o do site podem ser usados documentos de formatos variados como planilhas semanais fixadas em murais ou ferramentas de trabalho cooperativo que sirvam como agenda coletiva com as tarefas que cada um tem que fazer e com informa es que o coordenador do site possa ou precise disponibilizar para toda a equipe tais como datas de reuni es marcadas etc Soraya atualmente respons vel pela supervis o das tarefas realizadas pela equipe de manuten o de onde certamente resulta sua preocupa o com quest es tamb m ligadas ger ncia de processos de trabalho Entretanto a preocupa o com o papel da documenta o nos processos de trabalho da equipe evidenciou se como uma caracter stica de todos os entrevistados alocados em tarefas de Manuten o do site conforme foi registrado na entrevista com o Programador Marcelo Hess no caso de um site onde tem v rias pessoas trabalhando juntos bom ter tudo unificado em um lugar s que seja f cil de usar para que outras pessoas que venham a trabalhar poderem usar E se for em html f cil porque naveg vel O formato descrito pelo entrevistado o utilizado atualmente para a disponibiliza o da documenta o o
35. e Demandas do processo de Manuten o do site Atrav s da identifica o dessa categoria foi poss vel relacionar v rias caracter sticas e demandas do processo de manuten o do site da PUC Rio que demanda atualiza o di ria r pida e organizada Conforme dito anteriormente uma caracter stica identificada foi o fato da natureza das tarefas de manuten o proporcionarem aos membros da equipe a elas alocados uma rica e intensa intera o com o site e seus usu rios o que resulta em um retorno de ordem bastante criativa por parte desses profissionais no que diz respeito contribui es nos processos de melhorias e re design do site Conforme relatado por Soraya Atan zio Analista de Sistemas alocada em fun es de Manuten o do site o contato constante com o site proporcionado pela pr pria fun o de estar alterando o diariamente aliado ao contato com o p blico alvo atrav s do acesso s mensagens enviadas pelo mesmo ao site desencadeiam um processo de gera o de id ias para implementa o de melhorias no site baseadas em casos reais de uso Como Webmaster e coordenadora do site da PUC Rio constatei que os membros da equipe de manuten o sempre contribuiram muito em id ias no PUC Rio Certifica o Digital N 0015561 CA 101 desenvolvimento de novas vers es ou novos recursos do site Sendo que uma caracter stica dessa contribui o o fato da mesma ser resultado da observa o do uso do site por se
36. e Inform tica est o muito ligados a gente poderia ter uma metodologia para nos ajudar a separar isso a colocar as documenta es nos devidos lugares e fazer uma coisa naveg vel tanto pra quem de Design quanto para quem de Inform tica O Designer Alan Lima alocado em fun es de Desenvolvimento do site sugeriu um formato de documenta o que mostre tr s vis es de um mesmo elemento de um site uma sob o aspecto de Design uma sob o aspecto de Inform tica e uma com uma vis o geral Para a Designer Flavia Aucar Soler alocada em fun es de Manuten o e Desenvolvimento do site a tela seu espa o de trabalho e um grande elemento gr fico com elementos dentro A forma que melhor compreende uma documenta o relacionada aos aspectos do site que considera da rea de Inform tica atrav s de texto e exemplos de uso As rotinas ou fun es programadas em linguagem Javascript utilizadas na implementa o de algumas das funcionalidades do site da PUC Rio foram usadas como exemplo Para Flavia se o programador documentar o funcionamento das mesmas atrav s de textos descritivos acompanhados de exemplos do c digo ela capaz de faze los funcionar em novas p ginas uma vez que tem algum conhecimento da linguagem Javascript e dom nio da linguagem HTML Sobre as formas de representa o da informa o e formatos de documenta o aqui relacionados importante ressaltar o seguinte 1 Todos
37. e que a atual vers o do manual online apresenta problemas de usabilidade j que foi constatado que alguns dos entrevistados precisaram ter seu uso explicado para melhor conseguirem trabalhar com ele Ele definitivamente n o intuitivo Os problemas detectados nessa vers o do manual certamente s o decorrentes do fato do mesmo ter sido um dos primeiros manuais de sites existentes Conforme registrado em Sanders 1998 por volta dos anos de 1998 e 1999 quando o manual do site da PUC Rio foi projetado Designers e outros profissionais ligados a Web pouco falavam sobre documenta o de sites sendo que a grande maioria dos sites existentes na poca n o se preocupavam com esse aspecto Portanto em 1998 e 1999 n o haviam padr es nem regras estabelecidos para embasar o desenvolvimento do manual do site da PUC Rio Toda metodologia e conhecimentos aplicados em seu desenvolvimento foram importados de outras reas Al m disso na poca de sua constru o o perfil da PUC Rio Certifica o Digital N 0015561 CA 113 equipe era bem diferente do da atual equipe onde existiam apenas dois funcion rios eu e a Analista de Sistemas Soraya Atan zio na poca ocupando o cargo de auxiliar t cnico Para o desenvolvimento e manuten o do site cont vamos com a ajuda de estagi rios que permaneciam por pouco tempo por isso est vamos constantemente treinando novos estagi rios Por esse motivo o manual foi projetado para atender nossas pr
38. eb site no que diz respeito a formatos e m todos de documenta o que contemplem os aspectos de ambas as reas e considerando se tamb m o uso da documenta o como uma ferramenta de apoio ao processo de manuten o do site v rias vis es surgiram PUC Rio Certifica o Digital N 0015561 CA l 108 Utilizar folhas de estilo definindo se classes de objetos que est o sendo utilizadas no site aos quais s o associadas determinadas caracteristicas de acordo com uma regra caracteristicas visuais tipologia tamanho caracteristicas que influem no visual final Exemplo voc vai usar determinado estilo em todos os cabe alhos ou em todas as imagens que aparecem em determinado nivel do site Teria se ent o estilos que s o defini es de uma composi ao visual associados a uma regra de aplica o De acordo com Jo o Condack Analista de Sistemas alocado em fun es de Desenvolvimento do site essa seria uma forma de representar a parte de Design de maneira a tornar a documenta o do site mais unificada Todos apontaram o uso de texto como uma forma clara de transmitir informa es entre profissionais de reas diferentes desde que sejam tomados cuidados com o uso de jarg es e termos t cnicos referentes a uma s rea Se considerarmos cada p gina de um site como sua Interface verificamos que os elementos de Design e Inform tica est o intrinsecamente ligados onde sua intera o com o usu rio e funcionalid
39. ece Depois de um tempo voc vai na documenta o e olha PUC Rio Certifica o Digital N 0015561 CA 104 A Manuten o significa o site estar sempre atualizado sempre fresquinho diferente do jornal No jornal voc le o de hoje e joga fora Voc nao joga o site de hoje fora Entao voc precisa de agilidade na mudan a das informa es bom preciso ter processos ligados a tempo como manuten es fixas outros ligados a passo a passo a sequ ncia de tarefas a serem feitas utilizar o m ximo da tecnologia para automatizar o processo utilizar recursos de banco de dados ter cuidado com a estrutura do site No que diz respeito a cria o de novas p ginas o Programador Marcelo Hess citou os v nculos links ou elos entre p ginas como algo importante e necess rio ser observado e a Designer Flavia Aucar Soler citou a estrutura do site Tanto os v nculos quanto a estrutura s o elementos do site que se atualizados de forma incorreta podem levar o usu rio a se perder Portanto sendo os v nculos e a estrutura dois elementos que sustentam a navega o de um site os mesmos devem ser cuidadosamente observados durante o processo de manuten o 5 9 Quest es ligadas ao usu rio O processo de manuten o de um site sob o ponto de vista dessa disserta o possui tr s tipos de usu rios O primeiro a pr pria equipe de manuten o do site que para a realiza o de suas tarefas po
40. ela equipe de manuten o conforme apontado pelo Designer Alan Lima os produtores desse material devem ter em mente que o objetivo n o somente registrar o processo mas permitir a realiza o da manuten o de forma correta sem erros e r pida costumo usar imagens e textos porque se a inten o fazer com que outra pessoa entenda importante usar texto tamb m um manual deve ser algo que a pessoa recorre por ultimo Deveria ser o ltimo recurso muitos manuais s o feitos pelos pr prios projetistas que s vezes esquecem que nem todos entendem o jarg o da rea 6 Jones 1980 apresenta m todos de projeto onde separa se a l gica do objeto da sua l gica de uso Se considerarmos um site como um objeto poderia se para fins de documenta o separar da Interface seus aspectos de funcionalidade e programa o utilizando se de recursos da Inform tica para document los deixando como parte da mesma os aspectos gr ficos de forma que os mesmos possam ser documentados atrav s de t cnicas tradicionais de documenta o de Design 7 De acordo com Berners Lee 1990 devido a sua estrutura baseada em hipertextos a Web mostra se adequada a documenta o e compartilhamento de informa es de um projeto Podendo portanto se servir dessa caracter stica para documentar Web sites Ou seja a documenta o do site em uma estrutura de hipertexto gerada ou n o dinamicamente e associada a pr pria estrurura
41. en o e Desenvolvimento do site baseado em sua pr pria experi ncia essa hist ria de dizer que n o d tempo documentar eu acho besteira Eu acho que s n o daria pr atualizar a documenta o de alguma coisa se n o tivesse tempo se tivesse milh es de coisas pr fazer e se n o desse tempo MESMO fazer A gente tem sempre que pensar em alterar a documenta o quando altera alguma coisa do c digo alguma coisa do HTML Tem que atualizar Tem como fazer vi vel completamente vi vel Mesmo em circunstancias de extrema pressa ou tens o ou com outras tarefas j esperando para serem realizadas consigo pelo menos anotar que tenho que fazer a documenta o para no momento que terminar essas outras tarefas que est o esperando fazer a documenta o mas voc s deve deixar para depois se essas outras tarefas forem extremamente urgentes porque o certo voc fazer a documenta o logo ap s fazer a altera o a tarefa s deve ser considerada finalizada quando a documenta o estiver atualizada Ou seja poderia se dizer que em um projeto de manuten o a tarefa s deve ser considerada conclu da quando a documenta o estiver atualizada caso envolva documenta o Nem toda tarefa de atualiza o requer modifica o da sua documenta o Na verdade a maior parte n o demanda O que justifica ainda menos a ideia da inviabilidade dessa PUC Rio Certifica o Digital N 0015561 CA 5 6 95
42. eo cassete onde as vezes n o consta de forma clara no indice as fun es dispon veis no aparelho ou nas p ginas de instru es o significado de alguns c digos n o sejam claramente explicados tais como SP LP EP ou sejam utilizadas palavras em idioma estrangeiro desacompanhadas de qualquer tradu o assumindo se que as mesmas s o de dom nio comum Stop Record Play Pause VCR Exit Timer Sleep No projeto da documenta o de um Web site que demande atualiza o r pida di ria e organizada como o caso do site da PUC Rio interessante observar o que dito por Soraya Atan zio Analista de Sistemas alocada em fun es de Manuten o do site sobre os fatores cr ticos presentes no processo de manuten o Uma sistematiza o para mim fundamental tempo controle controle no sentido de sistematizar as atividades uma caracter stica embutida no trabalho sen o n o funciona Preciso sistematizar organizar uma coisa meio que passo a passo e ter um controle do que est sendo feito de tudo Mesmo que comece uma tarefa de manuten o e n o acabe hoje preciso que ter controle de onde eu parei ou quem eu pedi para fazer ter um controle um tempo determinado um prazo Uma sistematiza o para mim fundamental importante dar um retorno para quem me passou a tarefa porque o controle dessa pessoa tamb m sen o fica uma vala no meio do caminho importante tamb m dar um retorno par
43. er stica dessa rea Flavia Aucar Soler Designer Flavia Aucar Soler Designer alocada em fun es de Manuten o e Desenvolvimento do site requer essa agilidade n o deu certo tenta outra outra outra at achar uma solu o r pida que n o demande aquele tempo muito grande pois a Internet uma coisa que veloz Alan Lima Designer alocado em fun es de Desenvolvimento do site Velocidade algo muito presente em um projeto de internet importante observar inclusive que o fator tempo tamb m afeta n o s aspectos de manuten o como tamb m afeta mais gravemente projetos de desenvolvimento para a Internet do que outros tipos de projetos conforme dito pelo entrevistado Jo o Condack Analista de Sistemas alocado em fun es de Desenvolvimento do site Hoje a gente est trabalhando com OOHDM que uma metodologia para WEB para desenvolver sistemas hiperm dia e web um deles sendo que como a gente est com problemas de tempo a gente est fazendo algumas altera es nesse m todo para diminuir o tempo que a gente precisa para fazer o projeto 12 A metodologia OOHDM gera documenta o conforme visto no Cap tulo 2 13 O projeto ao qual refere se o entrevistado o Sistema de Apoio a Gar ncia do Site da PUC Rio em fase de desenvolvimento e com grande urg ncia de implementa o j que ir facilitar a ger ncia de conte do publicado no site PUC
44. ge por essas experiencias de voc ver todo dia algu m reclamando da mesma coisa ent o voc passa a querer arrumar um jeito de solucionar isso Ent o voc passa a produzir isso na sua cabe a e as id ias v o surgindo Antigamente eu n o anotava nada Agora eu anoto Al m da rela o entre o projeto de desenvolvimento de um Web site e seu processo de manuten o uma outra quest o relacionada ao processo de projeto abordada nas entrevistas tinha rela o com as diferen as existentes entre um projeto de um Web site e um projeto de um outro produto qualquer fosse um sistema de inform tica ou um produto de Design um carro ou um sapato por exemplo O objetivo desse questionamento era tentar identificar aspectos que pudessem influenciar na gera o e uso da documenta o ou dos registros dos projetos Dois pontos ficaram bastante evidentes o fator tempo e o p s uso dos produtos tamb m referido como sobre vida tempo de uso tempo de garantia A seguir est o destacados alguns trechos das respostas dos entrevistados Jo o Condack Analista de Sistemas alocado em fun es de Desenvolvimento do site existe diferen a porque existem sistemas que n o s o projetados para pessoas usarem sistemas que servem a outros sistemas sistemas que servem a mecanismos ent o isso tem um impacto na cria o em como ele vai trabalhar como deve responder as coisas Hoje a gente est trabalhando com OOHDM que uma metodo
45. incipais necessidades da poca documentar o site e servir como uma ferrammenta que nos poupasse algum tempo no treinamento dos estagi rios Com as modifica es ocorridas no perfil da equipe o Manual sofreu algumas altera es e inclus o de novas informa es Entretanto luz do que foi levantado nesse trabalho recomenda se um projeto de re design do mesmo Deve se tamb m tentar automatizar o m ximo poss vel sua atualiza o j que ela feita manualmente Sob esse aspecto o sistema de apoio a ger ncia do site atualmente em desenvolvimento pode vir a incorporar v rios recursos de automatiza o da documenta o 5 12 Considera es finais No processo de desenvolvimento e manuten o do site da PUC Rio a documenta o ocupa um papel fundamental conforme pode ser constatado atrav s desse trabalho v lido ressaltar que esse registro assume uma fun o de ainda maior import ncia quando consideramos o fato do site ter sido um dos primeiros existentes no Brasil o que o cerca de estreitas rela es com fatos marcantes da hist ria da Internet em nosso pa s Por volta do mesmo ano em que a reestrutura o e documenta o do site da PUC Rio foram iniciados 1998 poucos Designers preocupavam se em se aprofundar nas quest es relacionadas a documenta o de Web sites conforme registrado no trabalho de Sanders 1998 Ap s todo o levantamento realizado para essa disserta o verifica se que o tema continua receben
46. l N 0015561 CA 106 Em rela o ao usu rio visitante do site foi evidenciado o fato de ser para quem na verdade a equipe de manuten o trabalha No caso do site da PUC existem v rios perfis para esse tipo de usu rio Entre eles destacam se alunos de gradua o alunos de p s gradua o ex alunos professores pessoal administrativo com interesse em divulga o de informa o institucional candidatos ao Vestibular empresas interessadas em buscar curr culos de nossos alunos e pessoas com interesse geral em conhecer a universidade Para esse usu rio que navega em um site com informa es para p blicos com varia es de perfil importante que a hierarquia das p ginas seja bem identificada para que ele n o se perca No caso do site da PUC Rio o Designer Alan Lima considera importante que o mesmo seja documentado pois devido ao fato dele ter sido um dos pioneiros no Brasil al m de precisar ter sua hist ria registrada o p blico que o visita s vezes n o est interessado somente na informa o que ele disponibiliza mas tamb m no modo como o site foi feito e quais conceitos est o envolvidos em sua cria o Considerando o usu rio como aquele que solicitou a atualiza o importante que lhe seja dado um retorno sobre a realiza o da tarefa J em rela o s necessidades da equipe de manuten o do site que para executar suas tarefas precisa lidar com um produto que n o necessariamente foi ela quem ger
47. logia para WEB para desenvolver sistemas hiperm dia e web um deles sendo que como a gente PUC Rio Certifica o Digital N 0015561 CA 99 est com problemas de tempo a gente est fazendo algumas altera es nesse m todo para diminuir o tempo que a gente tem para fazer o projeto mas estamos fazendo de forma que n o altere a documenta o Soraya Atan zio Analista de Sistemas alocada em fun es de Manuten o do site tempo de garantia tempo de uso sobre vida O site voc pode ir modificando para que se mantenha vivo Um sapato voc pode limpar cuidar mas um dia ele vai acabar E o site nao como se ele ficasse se reproduzindo e se mantendo vivo o tempo todo A manuten o parte dessa garantia dessa sobre vida Marcelo Hess Programador alocado em fun es de Manuten o e Desenvolvimento do site a principal diferen a que um site est muito mais ligado a manuten o que os outros Alan Lima Designer alocado em fun es de Desenvolvimento do site Velocidade algo muito presente em um projeto de Internet Existe um ponto comum satisfa o do usu rio alcan ar o objetivo final sob o ponto de vista de uso posterior tem o p s uso o exemplo do pote de maionese todo mundo tem em casa Quando acaba posso usar como porta caneta vou pintar fazer outro uso e outro produto Serve agora para outra finalidade que a que aquela pessoa que tem
48. lta de m todos e padr es de projeto existentes conforme dito anteriormente De certa forma foi o pre o pago por seu pioneirismo na rea Quando tornou se um instrumento de comunica o institucional formal ele j estava grande o suficiente para demandar um processo de documenta o e reestrutura o demorado complexo mas ao mesmo extremamente rico sob v rios aspectos inclusive aos que dizem respeito ao tema tratado nessa disserta o Sua equipe de manuten o e desenvolvimento j h muitos anos acostumada a trabalhar em um ambiente interdisciplinar com profissionais de Design e Inform tica produzindo e atualizando a documenta o do site contribuiu imensamente para a realiza o desse trabalho atrav s da grande experi ncia e profunda consci ncia de suas necessidades e processos de trabalho da equipe Com rela o a vis o do Gerente do site em respeito s quest es aqui discutidas como no momento ocupo o cargo de Webmaster e coordenadora do site da PUC Rio n o fazia sentido entrevistar a mim mesma embora o processo de aplica o das entrevistas tenha me levado a refletir sobre todos os aspectos expostos equipe Era como se eu estivesse vivendo uma esp cie de auto entrevista silenciosa Portanto para o aprofundamento do tema tratado optei em dirigir o foco do trabalho para o papel da documenta o no processo de manuten o e desenvolvimento do site da PUC Rio visto atrav s da tica de sua PUC Rio Certifica
49. menta o deve registrar o processo dessa vida PUC Rio Certifica o Digital N 0015561 CA 89 5 4 Informa es que devem constar na documenta o e atualiza o da documenta o No que diz respeito a itens de conte do a constar na documenta o de um site al m das encontradas no atual manual do site da PUC Rio foram tamb m citados pelos entrevistados Informa es de registro do processo de constru o do site o porque das escolhas efetuadas o objetivo do site t cnicas utilizadas na constru o quais foram as pessoas envolvidas quais usu rios foram utilizados para teste onde est o armazenadas as c pias de seguran a dos arquivos do site onde s o salvos os arquivos localmente no caso do site estar utilizando uma tecnologia espec fica de um software seja para constru o das p ginas HTML ou de tratamento de imagens etc n o necess rio repetir na documenta o conceitua es relacionadas ao uso dos softwares ou instru es para cria o ou atualiza o de elementos atrav s dos recursos dos mesmos Podem ser feitas refer ncias s p ginas dos manuais dos softwares onde essas explica es s o dadas Exemplo para entender melhor o que um template leia o manual do programa Macromedia Dreamweaver vers o 4 0 pag X Informa es preferencialmente visuais sobre testes de usabilidade do site link para a p gina de estat sticas de uso do site listas de pend
50. ndamental durante o processo de cria o e desenvolvimento do projeto Ballay 1990 fundamental que os registros ou documenta o do mesmo a serem utilizados como material de apoio s tarefas de manuten o considerem o estabelecimento de padr es na representa o da informa o de forma que futuras atualiza es da pr pria documenta o sigam um padr o nico Esse procedimento evitar que uma vez finalizado o projeto a documenta o de novas p ginas criadas ap s a implementa o do site sejam documentadas atrav s de formas de representa o escolhidas por quem estiver respons vel pela elabora o da documenta o o que pode vir a descaracteriz la corrompendo seu projeto original Tal fato tamb m pode vir a afetar o ritmo de realiza o das tarefas uma vez que a equipe de manuten o do site ter que lidar com diferentes formas de representa o correndo o risco de ter que reaprender o uso da documenta o sempre que a mesma venha a ser alterada ou acrescentada de novos m dulos PUC Rio Certifica o Digital N 0015561 CA 87 4 As formas de representa o da informa o bem como o formato da Documenta o n o podem ser confundidos com os processos de cria o e atualiza o da mesma Os primeiros referem se a apresenta o e comunica o da t cnica Os segundos est o relacionados aos processos de trabalho da equipe 5 Nem sempre os registros do projeto de um site est o adequados ao uso p
51. nline do site da PUC Rio conforme apresentado no Cap tulo O site da PUC Rio sua equipe e documenta o Quando solicitado a pensar se haveria um elemento nos projetos de Web sites que seria fruto da rela o existente entre Design e Inform tica Marcelo respondeu que as Interfaces de Webmail Servi os de Correio Eletr nico acessados via uma interface Web s o um elemento que basicamente s existe na Web Em seguida foi solicitado a responder como poderia ser a documenta o desse elemento Eis a resposta Eu tentaria botar na documenta o o prop sito de cada elemento da interface para que que serve porque foi feito como uma coisa s e como os elementos se PUC Rio Certifica o Digital N 0015561 CA 85 relacionam seria bom ter exemplos de como se faz a p gina Diagramas video mostrando as diferentes etapas ou uma anima o Um video de um usu rio usando mostrando diferentes erros que o usu rio cometeu usando porque as pessoas pensam diferente Algu m pode pensar que um elemento da interface serve para alguma coisa outra pessoa n o ent o exemplos s o bastante bons tanto para pessoas de Inform tica quanto de Desenho Industrial Ainda sobre o formato da documenta o Marcelo acrescentou o seguinte j que existem elementos de Design e de Inform tica no site ou n o como o caso da Interface que considera como veremos mais frente um elemento do site onde Design
52. nstru o de um site Para sua atualiza o necess rio alterar apenas um arquivo e a altera o reflete em todos os pontos do site onde o recurso est sendo utilizado S o amplamente utilizados em v rios sites inclusive no da PUC Rio PUC Rio Certifica o Digital N 0015561 CA 97 manuten o Certamente um projeto de site que considere aspectos e demandas do processo de manuten o tender a economizar recursos empregados no processo de atualiza o do site principalmente homem hora pois as tarefas tender o a ser otimizadas ou seja ser o realizadas no menor tempo poss vel envolvendo o menor n mero de pessoas e com baixa taxa de ocorr ncia de erros A Analista de Sistemas Soraya Atan zio e o Designer Alan Lima conforme dito anteriormente compartilham a id ia de que a manuten o de um site deve ser encarada como um projeto tanto quanto a constru o onde a documenta o gerada seria um de seus produtos Essa vis o poderia ser complementada com a recomenda o de que uma metodologia de desenvolvimento de projetos para a Web poderia levar em conta a gera o incluindo a implementa o de ferramentas que servissem s demandas do processo de manuten o do site O site resultante teria um custo mais alto que sites gerados sem essa preocupa o mas bem prov vel que os benef cios no processo de manuten o resultariam em uma excelente rela o custo benef cio Entretanto seria necess rio um estud
53. o seja em partes ou completa importante ressaltar que as formas de representa o at agora apresentadas foram citadas pelos entrevistados durante as entrevistas quando o foco da quest o 11 NT ae a E ro A As Wizards s o instru es que guiam o usu rio passo a passo na realiza o de uma tarefa e s o amplamente utilizados em procedimentos de instala o de programas PUC Rio Certifica o Digital N 0015561 CA 83 estava relacionado ao processo de transmiss o da t cnica a ser utilizada na realiza o de tarefas de manuten o do site No que diz respeito a formas de representa o utilizadas durante o processo de cria o e desenvolvimento do site outras formas de representa o tamb m foram citadas Formas de representa o utilizadas pelos profissionais de Inform tica durante o processo de desenvolvimento fluxogramas desenhos muito eventualmente rascunhos representa es de alto n vel abstra es tabelas Impress es de p ginas da Web que serviram de inspira o essas servindo como forma de registro da id ia e n o como representa o de informa o que estar presente no site diagramas diagramas de classes de informa o diagramas que levam em conta o acontecimento no tempo diagramas de classes navegacionais Os Designers entrevistados tamb m utilizam as seguintes formas de representa o durante o processo de cria o e desenvolvimento do projeto
54. o mais aprofundado para avaliar essa rela o Um aspecto interessante do processo de desenvolvimento diz respeito contribui o criativa das equipes de manuten o no processo de re design do site Como Webmaster do site da PUC Rio pude perceber que os profissionais alocados em Manuten o sempre contribuiram de forma bastante criativa nos processos de re design do site da Universidade Durante a realiza o das entrevistas pude perceber o quanto uma liga o estreita e afinada entre o processo de desenvolvimento e de manuten o pode trazer benef cios para o site n o s sob o ponto de vista do processo de trabalho mas tamb m de natureza criativa Esse tipo de contribui o sem d vida resultado do contato di rio e intenso que a equipe de manuten o tem com o site e com seu p blico alvo atrav s da leitura das mensagens enviadas via correio eletr nico para a conta utilizada para contato com o p blico externo webmaster vrdc puc rio br conforme pode ser observado no relato de Soraya Atan zio Analista de Sistemas alocada em fun es de Manuten o do site quando indagada se considerava seu trabalho de natureza criativa O fato de eu estar o tempo todo atualizando eu estou constantemente olhando para o site e estou constantemente vendo coisas que poderiam melhorar Ent o nesse sentido pode ser criativo porque eu posso perceber coisas que podem auxiliar na cria o de qualquer coisa que possa vir a melhorar o site N
55. o pote deu algo que eu n o posso prever Eu n o posso imaginar o que cada um vai fazer com aquilo Agora num site Posso fazer um site bonito funcional mas quando vou olhar as estatisticas e ver como foi usado descobrir que nem todo mundo clicou em um link para olhar a informa o que eu queria passar mas para capturar uma imagem que tinha na p gina de t o bonita que ela ficou e est o usando na capa de um trabalho tamb m um p s uso que eu n o tenho como prever Mas o site n o acaba A maionese que estava no vidro acaba O site n o Flavia Aucar Soler Designer alocada em fun es de Manuten o e Desenvolvimento do site Projeto para a Web requer que eu seja criativa para resolver problemas e requer essa agilidade n o deu certo tenta outra outra outra at achar uma solu o r pida que n o demande aquele tempo muito grande pois a Internet uma coisa que veloz e seja a melhor solu o para aquele caminho Tem que achar um caminho e entrar nele semelhan a todos devem se preocupar com o uso Em um sistema pr Web tem que pensar que ele pode crescer entao n o se pode fazer uma coisa muito fechada Sobre Redesign uma semelhan a entre um projeto de um site e um outro qualquer Um carro tem um tipo de banco e voc vai lan ar o modelo do ano seguinte muda s o tipo do volante que tem o mesmo encaixe do outro e a lanterna da frente que tamb m o mesmo encaixe Voc otimiza o custo
56. ocumenta o ser utilizada por pessoas de reas diferentes Design e Inform tica A afirmativa apoia se no Referencial Te rico desse projeto Hackos 1994 e nos dados levantados nas entrevistas em especial ao que foi dito pelo Designer Alan Lima e pela Analista de Sistemas Soraya Atan zio Alan Lima Designer eu diria que a documenta o do site seria outro projeto Como eu vou fazer com que as pessoas entendam isso que eu fiz aqui e dessa forma Porque transmitir em palavras escrito ou graficamente completamente diferente de falar A forma como eu vou transmitir aquela informa o que a pessoa est procurando outro projeto Porque se ela viu o produto e n o soube como usar ela vai ter que pegar o manual e saber Agora se ela pega o manual e tamb m n o sabe nada funcionou Ou seja o projeto daquela forma como a documenta o foi feita n o funcionou Provavelmente n o teve uma metodologia provavelmente n o se pensou que a pessoa poderia usar tanto quanto eles imaginaram Quando voc vai documentar tem que projetar a forma como a documenta o ser utilizada uma coisa interessante vai ser uma descri o de um processo s que vai ser um processo PUC Rio Certifica o Digital N 0015561 CA 92 tamb m Eu vou ter que descobrir um meio de como informar o meio que eu usei uma coisa meio recursiva Ao longo dessa afirma o Alan citou como exemplo os manuais de aparelhos de vid
57. ominio comum anima o tamb m O Analista de Sistemas Jo o Condack tamb m citou a utiliza o de textos adequada para uma formaliza o bem descrita do problema atrav s de linguagem natural Tanto Jo o Condack quanto Marcelo Hess Programador alocado em fun es de Manuten o e Desenvolvimento do site utilizam coment rios dentro dos c digos dos programas e os consideram como uma forma de documenta o que servir aos profissionais que por ventura venham a ter que alterar aquele c digo Marcelo s vezes usa frases mais curtas e abreviadas e s vezes descritivas E Jo o acha pr tico trabalhar com ferramentas de programa o 10 Ea ia pis Era la E Formaliza o de um problema em Inform tica significa elaborar uma solu o computacional ou mesmo matem tica para um problema a ser resolvido ou tarefa aser executada PUC Rio Certifica o Digital N 0015561 CA 81 que geram documenta o tais como o software Visual age for Java e Java Doc A seguir s o apresentados alguns trechos extra dos das entrevistas onde fica clara a prefer ncia por uso de texto no processo de documentar Entre os entrevistados os Designers usam mais representa es visuais que textuais do que os profissionais de Inform tica Tal fato j era esperado devido ao que Arnheim 1986 identifica como a natureza visual do Design Verificou se tamb m que para os dois profissionais de Inform tica
58. onforme exemplificado pela Designer Flavia Aucar Soler Designer alocada em fun es de Manuten o e Desenvolvimento do site o equivalente a um desenho t cnico de um site mais complexo do que o de um outro produto Porque a parte da inform tica toda uma lista de c digos que faz ele funcionar E a parte de Design tem N imagens tem velocidade e para deixar ele mais r pido fa a isso ou fa a aquilo tem como salvar uma imagem para visualiza o mais r pida por exemplo um sapato eu n o vou salvar ou visualizar melhor ou pior dependendo de como eu salvar O site vai crescendo e se desenvolvendo e a documenta o tem que acompanhar isso Em outros tipos de produto n o tem isso o caso de um rel gio tem o desenho t cnico os materiais voc pode fazer v rios rel gios mas ele n o fica se modificando depois que o projeto conclu do A hora que ele mostra como ele mostra todo mundo vai saber como funciona N o fica modificando Conclui se que na escolha das formas de representa o de um site n o deve se esquecer sua caracter stica mutante e de que imposs vel prever a data das mudan as o que tamb m lhe d uma caracter stica de imprevisibilidade principalmente porque muitas mudan as solicitadas em um site s o decorrentes de decis es pol ticas que s o imposs veis de prever Levando se em conta o fator tempo como o site modifica se como se tivesse uma vida portanto sua docu
59. os entrevistados alocados em fun es de manuten o referiram se muitas vezes a instru es passo a passo com uma maneira f cil de transmitir a forma de realiza o de uma tarefa PUC Rio Certifica o Digital N 0015561 CA a 86 Algumas caracter sticas do atual formato da documenta o online do site foram citadas pelos entrevistados como desej veis para uma documenta o que venha a servir de apoio s tarefas de manuten o Entre elas destacam se estrutura baseada em hipertexto ou seja uma documenta o naveg vel e ligada a estrutura do pr prio site poder ser visualizada por toda a equipe oferecer op es de impress o N o poss vel quantificar o quanto a prefer ncia por essas caracter sticas est relacionada ao fato da equipe j estar acostumada a trabalhar com o atual formato de documenta o do site da PUC onde o processo de manuten o flui sem grandes problemas e do fato da equipe nunca ter sido exposta a nenhum outro formato de documenta o de sites Seria necess rio um novo estudo para responder a essa quest o preferencialmente expondo a equipe a um outro formato de disponibiliza o da documenta o acompanhado de testes do seu uso nas tarefas de manuten o do site da PUC Conforme pode ser visto muitas s o as formas de representa o da informa o que podem ser utilizadas no registro de um projeto e na gera o de sua documenta o Embora essa riqueza de possilidades seja fu
60. os prop sitos de uso da equipe de manuten o Outros aspecto diferencial na rela o documenta o manuten o de um Web site que demande atualiza o r pida di ria e organizada em rela o a qualquer outro sistema de inform o na web ou n o que n o demande essa frequ ncia e rapidez de atualiza o mais uma vez o fator tempo O fato da Web estar constantemente sendo atualizada e demandar rapidez nesse processo pode levar ao equ voco de que n o d tempo documentar mas exatamente por demandar rapidez na atualiza o sem comprometimento da consist ncia que a documenta o assume um papel de garantia conforme j dito por Soraya Atan zio Analista de Sistemas alocada em fun es de Manuten o do site A importancia da documenta o nesse processo a de dar independ ncia da equipe n o depender de pessoas que conhe am como realizar a tarefa e garante minimizar os riscos minimizar os erros E voc fazer r pido e sem errar Embora toda metodologia possua alguma forma de limita o o enfoque metodol gico empregado na gera o de uma documenta o a ser utilizada no processo de manuten o de um site deve certamente estar atento aos processos de trabalho da equipe bem como s necessidades decorrentes das caracter sticas de algumas fun es dentro da mesma como as da equipe de manuten o Apesar da padroniza o de nomes de arquivos e diret rios s tenha sido citada por um dos
61. ou importante lembrar que as ferramentas de apoio ao trabalho manuais impressos ou on line ou sistemas de apoio a manuten o e ger ncia devem ser de f cil uso Conforme dito pelo Designer Alan Lima muitos manuais sao feitos pelos pr prios projetistas que s vezes esquecem que nem todos entendem o jarg o da rea O entrevistado tamb m salientou que o objetivo de qualquer produto fazer com que o usu rio alcance seu objetivo final portanto a l gica de funcionamento do mesmo deve ser a l gica do usu rio 5 10 reas de fronteira e interse o entre Design e Inform tica sua abordagem e tratamento Devido ao fato do projeto de um Web site incorporar elementos de Design e Inform tica onde profissionais de ambas as reas trabalham em sua constru o PUC Rio Certifica o Digital N 0015561 CA 107 naturalmente emergiram em todas as categorias identificadas ao longo do que foi apresentado at agora nesse cap tulo aspectos de fronteira e interse o entre as duas citadas reas Entretanto achei importante a identifica o de uma categoria explicitamente espec fica a esse respeito atrav s da qual pudessem ser revistos alguns aspectos j detalhados ao longo dessa disserta o bem como apresentados outros Todos os entrevistados consideram um site um produto virtual de Design e Inform tica onde s vezes muito dif cil definir onde est a fronteira entre as essas reas Funcionalidade Interfac
62. ou com necessidade de atualiza o divulgar claramente no site sobre a inclus o dessa nova p gina 4 A Interface com o usu rio deve ser f cil de usar de forma que ele n o precise recorrer a manuais ou ajuda para entender seu funcionamento 5 A quest o de incompatibilidade entre os diversos browsers tamb m afeta a todos os usu rios j que demanda que a equipe que projeta e mant m o site precise fazer testes em browsers diferentes muitas vezes em vers es diferentes do mesmo browser antes de dar a tarefa por acabada Esse fato afeta a equipe de manuten o tempo para realiza o da tarefa o usu rio visitante do site pode atrasar a publica o da p gina atualizada e o usu rio que solicitou a atualiza o pode atrasar o tempo de retorno sobre a realiza o da tarefa por parte da equipe de manuten o que tamb m afetada nesse processo 6 Conforme dito anteriormente pelo Programador Marcelo Hess e pela Designer Flavia Aucar Soler em processos de atualiza o preciso muito cuidado os v nculos links ou elos entre p ginas e com a estrutura do site pois s o dois elementos do site que se negligenciados podem levar o usu rio a se perder o que prejudicar a usabilidade do site ou poder deix lo com apar ncia de estar desatualizado l Porgrama para navegar em p ginas Web Entre eles os mais conhecidos atualmente s o o Microsoft Internet Exploraer e o Netscape PUC Rio Certifica o Digita
63. ou pelo menos iniciar alguma coisa Hoje eu penso a manuten o de forma mais ampla de como eu pensava algum tempo atr s Agora vejo como algo que deve ser muito estruturado e mudei minha visao pela necessidade pela experiencia 15 Felipe um Analista de Sistemas da equipe de Suporte T cnico do RDC que desenvolveu os primeiros CGTs para o site h muitos anos atr s Ele continua trabalhando no desenvolvimento de aplica es para o site Entretanto at o projeto de documenta o do site ser iniciado em 1998 todo o conehecimento e t cnica a respeito desses aplicativos encontrava se praticamente somente na cabe a do funcion rio Hoje em dia todos os CGT s est o documentados da a diminui o da depend ncia em rela o ao funcion rio j que outros conseguem executar fuun es antes somente executadas pelo funcion rio Fellipe utilizando se da documenta o PUC Rio Certifica o Digital N 0015561 CA 103 O projeto de manuten o pode ser feito pela equipe de manuten o e desenvolvimento Quem fez o site n o precisaria fazer todo o projeto redigir montar mas boa parte do conte do desse projeto de manuten o vai ser elaborado por quem desenvolveu o site que vai saber dizer o que foi utilizado como foi utilizado porque foi pensado daquela forma naquele momento Tem conte dos que devem ser elaborados por quem est fazendo o site como fontes estilos etc O que vai acontecendo depois que o site est p
64. quem elaborou os documentos seja diferente daquela do profissional que venha a utiliz los como ferramenta de apoio a realiza o de uma tarefa de manuten o do site Foram tamb m listadas formas de representa o da informa o formatos de documenta o e tecnologias considerados desej veis pelos entrevistados embora alguns desses n o dispon veis a eles no momento Semelhante ao que foi identificado pela pesquisa de Ballay 1990 na atual documenta o do Web site da PUC Rio tamb m foram encontradas diversas formas de representa o da informa o entre elas atrav s de imagens de fotografias de representa es procedurais de textos narrativos de exemplos Ap s a an lise dos dados obtidos com as entrevistas verificou se que a documenta o atrav s de textos n o somente utilizada por todos em maior ou menor escala como tamb m foi indicada como a forma mais f cilmente compreens vel de transmitir e receber uma informa o de forma que a mesma possa ser compreendida por profissionais de reas distintas no caso Designers e Profissionais de Inform tica Jo o Condack Analista de Sistemas alocado em fun es de Desenvolvimento do site Voc tem um objeto e tem especificado o que pode ser feito com esse objeto E voc pode fazer generaliza es em texto do que pode fazer e dentro dessas generaliza es quais sao as causas e caminhos do que pode ser feito Texto imagens s o formas de representar de d
65. r primeiro o todo de um problema Acrescentou que deveria ser desenvolvida ou utilizada uma metodologia mista de Design e Inform tica para melhor atender as demandas de um projeto para a Web De fato a l gica de pensamento dos Designers tende a ser diferente e de certa forma complementar a dos Programadores Portanto seria importante analisar quais informa es necessitam ser compreendidas pelos profissionais de cada rea para a realiza o de suas tarefas e adequar a transmiss o da t cnica a cada caso evitando se assim tamb m excessos nas explica es j que por exemplo um Designer raramente precisar ou ter condi es de alterar a l gica de um funcionamento de um elemento de um site escrito em c digo javascript Nesse exemplo espec fico a descri o detalhada sobre a realiza o dessa tarefa poderia ser explicada com uma vis o mais voltada ao entendimento por parte de um profissional da rea de Inform tica Uma explica o geral sobre o funcionamento do elemento bastaria ao profissional de Design que por outro lado precisaria de descri o detalhada da forma como atualizar a parte de de Design daquele elemento j que seria essa a rea na qual estaria envolvido caso fosse solicitado a fazer algum tipo de atualiza o Somente em rar ssimas exce es um Designer talvez viesse a ser solicitado a fazer atauliza o da parte de Inform tica de um elemento de um site Portanto sob o PUC Rio Certifica o
66. ramenta de apoio as tarefas de desenvolvimento e manuten o do referido Web site Foram consideradas quest es de Design e Inform tica bem como quest es de fronteira e interse o entre essas duas reas presentes nesse processo Minha imers o no ambiente de trabalho dos entrevistados muito contribuiu na elabora o dos resultados dessa pesquisa uma vez que ap s toda a informa o ter sido levantada pude continuar observando o uso da documenta o na realiza o das tarefas de desenvolvimento e manuten o luz dos cruzamentos de informa o que estavam sendo realizados o que enriqueceu bastante minha perspectiva de an lise N o restaram d vidas de que para o Web site em estudo sua PUC Rio Certifica o Digital N 0015561 CA 76 documenta o uma ferramenta fundamental em seu processo de desenvolvimento manuten o e ger ncia Os resultados aqui obtidos poder o ser explorados em trabalhos posteriores A pesquisa poder ser aplicada para melhoria da documenta o do pr prio Web site da PUC Rio ou utilizada como material de refer ncia para outras pesquisas onde poder ser estudado o papel da documenta o no processo de manuten o de Web sites com caracter sticas semelhantes s do aqui estudado Posso afirmar que o grande desafio desse trabalho foi encontrar refer ncias que tratassem das quest es de fronteira e interse o decorrentes da exist ncia de produtos com elementos de Design e Inform ti
67. recomenda o para um m todo ou metodologia aplicado a documenta o de Web sites Jo o Condack Analista de Sistemas alocado em fun es de Desenvolvimento do site sugeriu Poderia se continuar utilizando metodologias de Design para documentar aspectos de Design do site e metodologias de Inform tica para documentar seus aspectos de Inform tica e desenvolver um m todo ou uma esp cie de contrato para relacionar o uso de metodologias das duas reas Algumas das metodologias dispon veis para desenvolvimento de sistemas de informa o ou de sistemas hiperm dia n o contemplam de forma profunda os aspectos de Design quanto os de Inform tica de um Web site Algumas se aprofundam em aspectos da estrutura da informa o ou consideram predominatemente os aspectos de Inform tica ou focam predominantemente em aspectos de Design mas n o consideram de forma ponderada todos esses aspectos Essa caracter stica certamente afeta a documenta o gerada para os sites desenvolvidos atrav s dessas metodologias sendo que caso a mesma venha a ser utlizada como apoio a manuten o do site certamente documentos complementares ter o que ser gerados para cobrir a documenta o dos aspectos do site pouco cobertos pela metodologia utilizada em seu desenvolvimento Uma metodologia para documenta o de sites n o poderia ter um s olhar Eu n o poderia pensar s com o olhar da Inform tica nem s com o do Design Nesse momento e
68. rminado tempo e a caneta vai acabar a tinta E o site n o Voc pode estar modificando para que ele se mantenha vivo Um sapato voc pode limpar engraxar e ele vai se mantendo mas tem uma hora que ele vai acabar O site n o como se ele tivesse uma sobre vida muito maior como se pudesse estar se reproduzindo e se mantendo vivo o tempo todo S vai morrer se alguma coisa der errado nesse processo Acho que a manuten o parte dessa garantia de sobre vida Se voc entra num site hoje e est desatualizado entra amanh e est desatualizado ningu m entra mais Ele n o tem mais uma raz o de existir bvio que existem umas diferen as por exemplo o site da PUC ficou dois anos com a mesma cara mas a informa o estava atualizada ent o os acessos se mantinham porque o que a pessoa ia buscar ela encontrava mesmo que fosse com a mesma cara de sempre Ent o o processo de manuten o um ponto forte para manter esssa garantia de sobre vida A pessoa s entra quando ela encontra o que quer Hoje em dia eu vejo o processo de manuten o de um site como um projeto assim como o processo de desenvolvimento de site tamb m tem que ser um projeto tamb m tem que ter um projeto tamb m tem que ter uma metodologia tamb m tem que estar organizado e estruturado E a maioria dos sites que eu conhe o n o tem isso n o tem um projeto de manuten o aquela coisa feita sob demanda e por isso muita vezes resulta em bac
69. ronto nessa sobre vida as mudan as que se fizerem necess rias a equipe de manuten o capaz de dar continuidade sem a presen a de quem fez e ir aprimorando o projeto O ideal que o projeto de desenvolvimento e de manuten o comecem juntos mas n o precisam terminar juntos ou seja vamos projetar essa p gina e pensar o que nela pode ser alterado e como ou seja vamos pensar nessa p gina e vamos ter a manuten o dela fechada Mas vai ter uma hora que o site vai estar pronto e vai para o ar mas a manuten o vai continuar Ent o em cima do que foi feito paralelo ao desenvolvimento do site outras coisas v o surgir v o entrando telas novas Um produto do projeto de documenta o poderia ser um manual Algo que voc recorra Um projeto que documente que estruture a manuten o tempo controle controle no sentido de sistematizar as atividades uma caracter stica que se n o embutir no trabalho n o funciona Se eu n o sistematizar organizar uma coisa meio que passo a passo e ter um controle do que est sendo feito de tudo Mesmo que eu comece uma tarefa hoje de manuten o e eu n o acabe eu tenho que ter controle de onde eu parei ou quem eu pedi para fazer ter um controle um tempo determinado um prazo Uma sistematiza o fundamental Em Manuten o e Internet o mais importante quanto mais r pido O que voc puder fazer para estar atualizado e o mais r pido poss vel j q
70. se isso tiver bem documentado a s a gente consultar e vai ser mais facil entender Eu recorro a documenta o quando sou convocado a fazer tarefas de outras pessoas no caso de um site onde tem varias pessoas trabalhando juntos bom ter tudo unificado em um lugar s que seja f cil de usar para que outras pessoas que virem a trabalhar poderem usar e se for feito em html facil por que naveg vel Alan Lima Designer alocado em fun es de Desenvolvimento do site A documenta o funciona como um trouble shooting para resolver problemas se eu registrar eu posso melhorar alguma coisa recorro a documementa o se tenho que substituir algu m e uma tarefa que n o sei fazer Flavia Aucar Soler Designer alocada em fun es de Manuten o e Desenvolvimento do site Exemplo tenho um arquivos que explica como um gif foi feito os efeitos onde est o os arquivos originais etc uma receita At porque voc mesmo esquece Depois de um tempo voc vai na documenta o e olha O fato do Pedro estagi rio de Desenho Industrial recorrer a documenta o me libera de responder perguntas e o trabalho que ele fizer vai ficar muito pr ximo do que foi feito inicialmente por mim Vai sair com o mesmo efeito com a mesma imagem etc a documenta o agiliza o trabalho A documenta o tem que ser atualizada sempre Isso tem que ser uma norma do trabalho Entretanto verificou s
71. u p blico alvo e n o simplesmente uma id ia criativa n o embasada em caso de uso real Outras caracter stica o fato dessas contribui es tamb m no caso do site da PUC Rio sempre terem vindo acompanhadas de preocupa es ligadas a manuten o ou seja s o id ias que comtemplam a viabilidade e rela o custo benef cio da manuten o das mesmas Embora o processo de manuten o n o represente uma atividade criativa em si recomenda se que sites com equipes de manute o fixas podem e devem explorar o potencial criativo dessa equipes no desenvolvimento de novas vers es ou novos recursos do site Outro fator bastante evidente no processo de manuten o tempo ou seja os prazos para realiza o de tarefas de manuten o s o muito curtos s vezes contados n o em dias ou horas mas em minutos Da a import ncia do papel da documenta o no processo de manuten o Soraya Atan zio Analista de Sistemas alocada em fun es de Manuten o do site A importancia da documenta o nesse processo a de dar independ ncia da equipe n o depender de pessoas que conhe am como realizar a tarefa e garante minimizar os riscos minimizar os erros voc fazer r pido e sem errar Durante as entrevistas cada entrevistado independente de estar alocado ou n o em fun es de manuten o foi colocado diante de v rias quest es ligadas ao significado da manuten o para um Web site e sobre quest es rel
72. u tenho que pensar com olhar da pessoa que vai usar Eu n o sei quando o programador vai usar nem quando o designer vai usar mas ela tem que ter uma linguagem clara Alan Lima Designer alocado em fun es de Desenvolvimento do site Caracter sticas e Demandas do projeto de Desenvolvimento do site Atrav s dessa categoria procurou se identificar aspectos do processo de desenvolvimento de um site que podem vir a impactar em seu processo de manuten o Procurou se tamb m definir o papel da documenta o nessa rela o PUC Rio Certifica o Digital N 0015561 CA 96 Uma primeira preocupa o dos entrevistados alocados em fun es de Manuten o do site da PUC Rio foi a de que o projeto de desenvolvimento deve utilizar recursos na implementa o do site de forma a tornar sua manuten o um processo r pido e f cil de ser executado Soraya Atan zio Analista de Sistemas alocada em fun es de Manuten o do site vejo um processo paralelo entre a parte de Inform tica e de Design Sempre penso o que se pode fazer para tornar mais f cil a manuten o Marcelo Hess Programador alocado em fun es de Manuten o e Desenvolvimento do site Penso logo na manutencionabilidade como tornar o site mais f cil de ser mantido Se a manuten o n o for contemplada no desenvolvimento voc corre o risco de errar muito na manuten o Os dois Designers entrevistados manisfestaram preocupa
73. ue quando voc come a a atualizar significa que a coisa j est desatualizada Isso caracter stica dessa rea tamb m importante dar um retorno tamb m para quem passou a tarefa porque o controle dessa pessoa tamb m sen o fica uma vala no meio do caminho importante porque tem que dar um retorno tamb m para o usu rio que solicitou a atualiza o Marcelo Hess Programador alocado em fun es de Manuten o e Desenvolvimento do site a manuen o tem v rias questoes consertar um erro mudar uma informa o ou estrutura de uma p gina caso precise atualizar a documenta o a tarefa de manuten o s deve ser considerada finalizada quando a documenta o estiver atualizada Alan Lima Designer alocado em fun es de Desenvolvimento do site A manuten o significa vou voltar a usar seu site deve ser um processo r pido din mico Flavia Aucar Soler Designer alocada em fun es de Manuten o e Desenvolvimento do site O uso de Metodologia no desenvolvimento uma forma de organiza o e se alguem tentar reproduzir e dar continuidade com em industria quando do se tem o molde do corte Com o uso da metodologia a empresa n o perde o trabalho porque fica registrado Como fazemos aqui Exemplo tenho um arquivo que explica como um gif foi feito os efeitos etc Onde estao os arquivos originais etc uma receita At porque voc mesmo esqu

Capítulo 05 - Divisão de Bibliotecas e Documentação PUC-Rio

Contents

Download Pdf Manuals

Related Search

Related Contents

Cap&iacute;tulo 05 - Divis&atilde;o de Bibliotecas e Documenta&ccedil;&atilde;o PUC-Rio

Contents

Download Pdf Manuals

Related Search

Related Contents

Capítulo 05 - Divisão de Bibliotecas e Documentação PUC-Rio