6 referências bibliográficas - dbd.puc-rio.br · unimep, 1999. 7a. ed. ballay, joseph m. an...

27
118 6 Referências Bibliográficas ARNHEIM, Rudolf . El Pensamiento Visual. Ediciones Paidós Iberica SA. Barcelona.1986. AZEVEDO, Israel Belo de. O prazer da produção científica. Piracicaba, UNIMEP, 1999. 7a. ed. BALLAY, Joseph M. An experimental view of the design process. In: VENTURINO, Michael (Ed.) Selected readings in Human factors. Santa Monica (CA), human Factors and Ergonomics Society, 1990. 406p. pp 27-44 BARDIN, Laurence. Análise de Conteúdo. Lisboa (sem data). Edições 70. BELL, Judith. Doing your research project. Open University Press. Buckingham, 1987. BERNERS-LEE, Tim Berners-Lee Information Management: A Proposal [on- line] Mar 1989, Mai 1990, Disponível: http://www.w3.org/History/1989/proposal.html BERNERS-LEE, Tim Berners-Lee/ CN, R. Cailliau / ECP WorldWideWeb: Proposal for a HyperText Project [on-line] Nov. 1990, Disponível: http://www.w3.org/Proposal.html CASTELLS, Manuel. A Sociedade em Rede. São Paulo, Editora Paz e Terra, 1999. CHIZZOTTI, Antonio. Pesquisa em ciências humanas e sociais. COUTO, Rita. Design Social no Departamento de Artes & Design da PUC-Rio, Rio de Janeiro, 1994 – Entrevista DOMINGUES, DIANA - (Org) A Arte no Século XXI: a humanização das tecnologias. São Paulo Fundação Editora da UNESP, 1997. - (Prismas) FADUL, Anamaria. Novas Tecnologias de Comunicação. São Paulo: Summus, 1986 GATES, Bill. A estrada do Futuro. São Paulo: Companha das Letras, 1995 GIL, Antonio Carlos. Como elaborar projetos de pesquisa. São Paulo Atlas, 1991 GUAY, Tim. WEB Publishing Paradigms [on-line] Abr. 1995, Disponível: http://www.w3.org/ JONES, J. Christopher. Design Methods: seeds of human futures. Jonh Wiley &

Upload: vantuyen

Post on 11-Nov-2018

214 views

Category:

Documents


0 download

TRANSCRIPT

118

6

Referências Bibliográficas

ARNHEIM, Rudolf . El Pensamiento Visual. Ediciones Paidós Iberica SA.

Barcelona.1986.

AZEVEDO, Israel Belo de. O prazer da produção científica. Piracicaba,

UNIMEP, 1999. 7a. ed.

BALLAY, Joseph M. An experimental view of the design process. In:

VENTURINO, Michael (Ed.) Selected readings in Human factors. Santa

Monica (CA), human Factors and Ergonomics Society, 1990. 406p. pp 27-44

BARDIN, Laurence. Análise de Conteúdo. Lisboa (sem data). Edições 70.

BELL, Judith. Doing your research project. Open University Press. Buckingham,

1987.

BERNERS-LEE, Tim Berners-Lee Information Management: A Proposal [on-

line] Mar 1989, Mai 1990, Disponível:

http://www.w3.org/History/1989/proposal.html

BERNERS-LEE, Tim Berners-Lee/ CN, R. Cailliau / ECP WorldWideWeb:

Proposal for a HyperText Project [on-line] Nov. 1990, Disponível:

http://www.w3.org/Proposal.html

CASTELLS, Manuel. A Sociedade em Rede. São Paulo, Editora Paz e Terra,

1999.

CHIZZOTTI, Antonio. Pesquisa em ciências humanas e sociais.

COUTO, Rita. Design Social no Departamento de Artes & Design da PUC-Rio,

Rio de Janeiro, 1994 – Entrevista

DOMINGUES, DIANA - (Org) A Arte no Século XXI: a humanização das

tecnologias. São Paulo Fundação Editora da UNESP, 1997. - (Prismas)

FADUL, Anamaria. Novas Tecnologias de Comunicação. São Paulo: Summus,

1986

GATES, Bill. A estrada do Futuro. São Paulo: Companha das Letras, 1995

GIL, Antonio Carlos. Como elaborar projetos de pesquisa. São Paulo Atlas, 1991

GUAY, Tim. WEB Publishing Paradigms [on-line] Abr. 1995, Disponível:

http://www.w3.org/

JONES, J. Christopher. Design Methods: seeds of human futures. Jonh Wiley &

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

119

Sons, 1980.

HACKOS, Joann T. Managing Your Documentation Projects. John Wiley &

Sons, 1994.

KÖCHE, José Carlos. Fundamentos de Metodologia Científica: teoria da ciência

e prática da pesquisa. Petrópolis: Vozes, 1997.

LAKATOS, Eva Maria; MARCONI, Marina de Andrade. Metodologia Científica.

São Paulo, Atlas, 1991

LÉVY, Pierre. As Tecnologias da Inteligência. Rio de Janeiro: ed 34, 1993

LEMAY, Laura. Aprenda em 1 Semana HTML 4. Rio de Janeiro: Campus, 1998

LÜDKE, Menga e ANDRÉ, Marli E.D.A. Pesquisa em educação: abordagens

qualitativas.

São Paulo: EPU, 1986.

MACROMEDIA, Inc. Using Dreamweaver. San Francisco, 1999. Macromedia

MORAES, Dijon de. Limites do Design. São Paulo. Studio Nobel, 1999.

NICHOLS, BeLinda. Writing Web Documentation. [on line] Disponível:

http://hotwired.lycos.com/webmonkey/00/10/index3a.html?tw=e-business.

2000

NIELSEN, Jakob. Designing Web Usability. Indianapolis. New Riders Publishing,

2000

NIELSEN, Jakob. Usability Engineering. Cambridge. AP Professional, 1993

PÁDUA, Elisabete Matallo Marchesini de Pádua. Metodologia de Pesquisa:

abordagem teórico-prática. Campinas, SP, Papirus, 1998. 3ª. Ed.

PRESSMAN, Roger S. Software Engineering. McGraw Hill, Berkshire, 1994

PARENTE, ANDRÉ. Imagem Máquina. a Era das Tecnologias do Virtual. Rio de

Janeiro. Ed 34, 1993

RASMUSSEN, Jens. Skills, rules and knowledge; signals, signs and symbols, and

other distinctions in human performance models. In: VENTURINO, Michael

(Ed.) Selected readings in Human factors. Santa Monica (CA), human Factors

and Ergonomics Society, 1990. 406p. pp 61-70.

ROSSI, Gustavo Hector. Um Método Orientado a Objetos para o Projeto de

Aplicações Hipermídia Tese de Doutorado (Depto. de Informática) PUC-RIO,

1996

SALOMON, Délcio Vieira. Como fazer uma monografia. São Paulo, Martins

Fontes, 1999. 9ª. Ed.

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

120

SANDERS, Dinah. A proposal on documentation of the design process in online

environments. San Jose State University. School of Library and Information

Science. Theses. 1998

SANO, Darrell. Designing Large-Scale Web Sites. USA: Wiley Computer

publising, 1996.

SANTOS, Antônio Raimundo dos. Metodologia Científica: a cosntrução do

conhecimento. Rio de Janeiro. DP&A Editora, 1999.

SIEGEL, David. Creating Killer Web Sites (2nd Edition). Hayden Books ,1997

SIEGEL, David. Secrets of Successful Web Sites: Project Management on the

World Wide Web. Hayden Books, 1997.

SPITZ, Rejane. O papel da Computação Gráfica no Ensino do Desenho

Industrial: a percepção de dirigentes, docentes e alunos. Tese de Doutorado.

Depto de Educação, PUC-RIO, 1993

SCHWABE, Daniel; Rossi, G.; Barbosa, S. D. J. Systematic Hypermedia

Application Design Using OOHDM Artigo em Anais Em: Hypertext'96 -

Seventh ACM Conference on Hypertext - ACM. Washington DC, EUA. 1996.

116-128

SHIPMAN, Frank M; McCall, Raymond J.. Integrating Different Perspectives on

Design Rationale: Supporting the Emergence of Design Rationale from Design

Communication. [on-line] sem data Disponível:

http://www.csdl.tamu.edu/~shipman/aiedam/

STANTON, Neville; YOUNG, Mark S. A guide to Methodology in Ergonomics:

designing for human use. London, Taylor & Francis, 1999. 132 p. pp xii - 10

VANN COTT, Harold P. From control systems to knowledge systems. In:

VENTURINO, Michael (Ed.) Selected readings in human factors. Santa

Monica (CA), Human Factors and Ergonomics Society, 1990. 406 p. pp. 47-54.

WATERS, Crystal. Web, Concepção e Design. São Paulo: Quark do Brasil Ltda.,

1996.

WEINMAN, Lynda. Designing Web Graphics 3. Indianápolis: New Riders

Publishing, 1997

WEINMAN, Lynda. Coloring Web Graphics 3. Indianápolis: New Riders

Publishing, 1997

WILSON, Stephan. Using Computers to Create Art. New Jersey: prentice-Hall,

1986.

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

121

WÖDKE, Christina. Boxes and Arrows: Defining Information Architecture

Deliverables. sem data [on-line] Disponível:

http://www.webmasterbase.com/article.php?aid=326&pid=0

ZAMBELLI, Viviane Guimarães World Wide Web: um novo campo de atuação

do designer Dissertação (Mestrado em Design) - PUC-RIO , 1999.

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

122

ANEXO IRoteiro de Questões e perguntas das entrevistas

O objetivo desse roteiro de perguntas era guiar a entrevista de forma que

permitisse mapear a visão dos diferentes profissionais que compõem a equipe de

desenvolvimento e atualização do site da PUC-Rio cuja característica é ser um site

de grande porte, que demanda atualização rápida e organizada.

As questões se nortearam no seguinte:

- a importância da existência de uma documentação para o processo de

continuidade do site, levando-se em conta que isso possibilita preservar a

consistência dos dados e identidade visual do mesmo.

- na hipótese de que há necessidade do uso de uma metodologia apropriada

para a documentação de sites. Sendo que o questionário deve levantar quais

aspectos do site (e de seu projeto) devem ser documentados e como.

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

123

Teorias Questões Perguntas GuiasGerais e de identificação - Nome, profissão, formação, o que fez

anteriormente (background resumido)- O que você faz aqui?- O que é Web Design p/ você?

Questões de Design: formas derepresentação, o processo detrabalho, o uso de metodologia.

- Quais as principais características do seutrabalho?- Você considera seu trabalho de naturezacriativa? Porque? Se sim, com é seu processo decriação?- O que você entende por “projeto de Design”?- Como você representa/esboça seu trabalho?Desenhos, Esquemas?- Você usa alguma metodologia nodesenvolvimento do projetos?- Qual? Em que ela lhe ajuda? Quais benefíciosvocê vê que ela traz para os projetos?

Questões de Informática:formas de representação, oprocesso de trabalho, o uso demetodologia.

- Quais as principais características do seutrabalho? Quais Fatores sào característicos do seutrabalho? Você conseguiria imaginar como umDesigner responderia essa questão em relação aoseu trabalho?- Você considera seu trabalho de naturezacriativa? Porque? Se sim, como é seu processo decriação?- O que você entende por um projeto de Sistema?- Como você definiria projeto? Qual a diferençaentre projeto e “bacalhau”?- Como é seu processo de desenvolvimento?- Como você representa/esboça seu trabalho?Fluxogramas?- Você usa alguma metodologia nodesenvolvimento do projetos?- Qual? Em que ela lhe ajuda? Quais benefíciosvocê vê que ela traz para os projetos?

Produtos VirtuaisProjetos de sitesÁreas de fronteira e Interseçãoem Projetos de sites

- O que você entende por um produto virtual?- Você considera um site um produto de Designou projeto de Informática?- O quanto é de um, o quanto é de outro, o quantoé dos dois?- Você conseguiria descrever semelhanças entreos dois projetos, seja em metodologia, ou emoutro aspecto?- Você programa em alguma linguagem? / Vocêcria algum elemento gráfico?- Você pensa com a lógica do programador/doDesigner?- O que você vê de semelhante entre a lógica doprogramador e do Designer?

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

124

O processo de construção desites - desenvolvendo parareprodução

Observar se ele cita algumapreocupação c/ manutenção

- Fale sobre o processo de construção de um site- Quais os fatores que influenciam a construçãode um site?- Como você situa seu trabalho dentro desseprocesso de construção?- Na sua opinião, o quanto a forma que um site foiconstruído influencia na sua manutenção?- Você enxerga um site como um projeto?Porque?- Se sim, como você situa a metodologia dedesenvolvimento nesse contexto? Deve serusada? Qual? Um de Design? Uma deInformática?- Quais as formas de representação que vocêutiliza quando está projetando um site?- Seja um site um produto de Design ou sistemade Informática, o que você veria de diferenteentre um site e um sistema qualquer ou produtoqualquer, sob o ponto de vista dacriação/desenvolvimento/implementação emrelação ao seu uso posterior.

Questões ligadas à manutenção - O que você acha que a manutenção significapara o site?- Fale sobre o processo de manutenção de um site- Alguem faz algo que você não faz?- Se você tiver que subtituir alguém e precisasaber de algo que não foi você quem fez.- Quando é necessário criar novas páginas, o quedeve ser observado? Quais os cuidados

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

125

o papel da documentação nadocumentação e gerencia desites

- A que lhe remete a palavra documentação ou oato de documentar?- Você documenta seus projetos? Como?- Você acha importante documentar um site?Porque e para que?- Como você documentaria sua parte e como vocêacha que as outras partes deveriam serdocumentadas?- Em um site, o que você considera elemento deprojeto de design e elementos de projeto deInformática?- Um mesmo elemento pode ser consideradoelemento de design e de Informática?Exemplos???- Como você documentaria um elemento queconsidera só de Design, um que considera só deinformática, e um que considera uma interseçãodos dois?- Você acha que existem elementos de um siteque nasceram dessa relação entre Design einformática? Quais? Como documentá-los?- Qual a relação de dependência entre elementosde Design e Informática de um site?- Você acumula funções?- Como você acha que o que você faz devia serdocumentado, de forma a ser compreendido porpessoas de outras áreas, que precisem atualizarum site?- Como você gostaria de ver documentado o queoutro fez, para que você possa utiliza-lo. Cite umexemplo da sua área, um caso seu.- É necessária a existência de uma metodologiade documentação própria para sites? Porque? Oque está faltando nos formatos de documentaçãoatual?- Você acha que a documentação teria algumpapel no processo de manutenção de um site?Qual? (atualização/criação de novas páginas)

documentação dinâmica - Já que o site está sempre mudando, adocumentação teria que ser atualizada também.Se você concorda com isso, como acha que seriaa melhor forma de manter a documentaçãoatualizada? Se você não concorda, diga porque.

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

126

ANEXO II

ANÁLISE DE DADOS

FASE 1 - Material elaborado antes da transcrição das fitas:

dados que mais se evidenciaram durante as entrevistas, primeira

extração de categorias e primeiras conclusões

A denominada FASE 1 da análise de dados utilizou-se de anotações feitas

durante a realização das entrevistas: dados que mais se evidenciaram, primeiros

cruzamentos de dados, primeira extração de categorias e primeiras conclusões.

Foi usada codificação de cor para mais rápida localização de conteúdo

dentro do roteiro transcrito. A cor azul foi usada para diferenciar as peguntas

decorrentes das respostas dos entrevistados, bem como a identificação dos

mesmos. O código CONCLUSÃO – Gr, na cor laranja, foi utilizado para identificar

o que chamei de “pré-conclusões”, ou seja, aparente conclusões, mas que depois

seriam revistas durante a análise completa do dados

Questões Gerais e de identificação:

Perguntas Guias:

- Nome, profissão, formação, o que fez anteriormente (background

resumido)

- O que você faz aqui?

- O que é Web Design p/ você?

Dados que mais se evidenciaram durante as entrevistas:

As diferentes definições sobre o que é Web Design

Questões de Design (aplicadas somente aos Designers): formas de

representação, o processo de trabalho, o uso de metodologia.

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

127

Perguntas Guias:

- Quais as principais características do seu trabalho? Quais Fatores são

característicos do seu trabalho?

- Você considera seu trabalho de natureza criativa? Porque?

Se sim, com é seu processo de criação?

- O que você entende por “projeto de Design”?

- Como você definiria projeto? Você sabe o que significa “bacalhau” 19,

no jargão de Informática? Qual a diferença entre projeto e “bacalhau”?

- O que você consideraria um “bacalhau” em Design?

- Como você representa/esboça seu trabalho? Desenhos, Esquemas?

- Você usa alguma metodologia no desenvolvimento de projetos?

Qual? Em que ela lhe ajuda? Quais benefícios você vê que ela traz para os

projetos?

Questões de Informática (aplicadas somente aos profissionais de

informática): formas de representação, o processo de trabalho, o uso de

metodologia.

Perguntas Guias:

- Quais as principais características do seu trabalho? Quais Fatores são

característicos do seu trabalho? Você conseguiria imaginar como um

Designer responderia essa questão em relação ao seu trabalho?

- Você considera seu trabalho de natureza criativa? Porque? Se sim, como

é seu processo de criação?

- O que você entende por um projeto de Sistema?

- Como você definiria projeto? Qual a diferença entre projeto e

“bacalhau”?

- Como é seu processo de desenvolvimeto?

- Como você representa/esboça seu trabalho? Fluxogramas?

- Você usa alguma metodologia no desenvolvimento do projetos?

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

128

- Qual? Em que ela lhe ajuda? Quais benefícios você vê que ela traz para

os projetos?

Dados que mais se evidenciaram durante as entrevistas

- forma de documentação/representação comum a todos: texto

- Alan (DESIGNER) muito falou sobre uso de texto como uma forma de

representação.

- interessante discussão com os DESIGNERS (Alan e Flavia) a respeito

do que é artesanal e industrial.

João - ANALISTA DE SISTEMAS

. fez uma conexão com Design, como se em Design pudesse ser chamado de

bacalhau sendo feito com arte ou de forma experimental, e projeto como

algo industrial.

Entrevistados de Design e Informática associaram “bacalhau” como uma

forma arriscada de trabalhar, que aumenta a margem de erro. A palavra

RISCO apareceu várias vezes.

Outro termo mencionado: “conjunto”.

Questões: Produtos Virtuais, Projetos de sites, Áreas de fronteira e

Interseção em Projetos de sites

Perguntas Guias:

- O que você entende por um produto virtual?

- Você considera um site um produto virtual?

- Você considera um site um produto de Design ou projeto de Informática?

- O quanto é de um, o quanto é de outro, o quanto é dos dois? Os dois

19 Foi explicado ao entrevistado o significado do termo “bacalhau”, que no jargão de informáticasignifica um produto (programa ou conjunto de programas) que foi desenvolvido sem muitoscritérios ou metodologia, muitas vezes feito apenas para suprir uma necessidade imediata.

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

129

- Você conseguiria descrever semelhanças entre os dois projetos, seja em

metodologia, ou em outro aspecto? Ex: Projeto de um carro e de um sistema

computacional

- Você programa em alguma linguagem? / Você cria algum elemento

gráfico?

- Você pensa com a lógica do programador/do Designer?

- O que você vê de semelhante entre a lógica do programador e do

Designer?

- O você gosta de trabalhar com metodologia?

Dados que mais se evidenciaram durante as entrevistas

- Todos responderam que consideram um site um produto virtual.

- Houve uma predominância em considerar um site um produto de Design

e Informática

Flavia DESIGNER

- falou de funcionalidade na quarta pergunta.

- falou que o programador se apega 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 olhar primeiro o todo de um

problema.

- sobre metodologia, falou que o não uso tende a um trabalho na base de

tentativa e erro.

Quando falando de sites, o foco dirigiu-se a Sites Institucionais e muitos

exemplos do site da PUC foram citados.

Questões: O processo de construção de sites - desenvolvendo para

reprodução

Perguntas Guias:

- Fale sobre o processo de construção de um site

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

130

- Quais os fatores que influenciam a construção de um site?

- Como você situa seu trabalho dentro desse processo de construção?

- Na sua opinião, o quanto a forma que um site foi construído influencia

na sua manutenção?

- Você enxerga um site como um projeto? Porque?

- Se sim, como você situa a metodologia de desenvolvimento nesse

contexto? Deve ser usada? Qual? Um de Design? Uma de Informática?

- Quais as formas de representação que você utiliza quando está

projetando um site?

- Como vê o usuário nesse processo?

- Seja um site um produto de Design ou sistema de Informática, o que

você veria de diferente entre um site e um sistema qualquer ou produto

qualquer, sob o ponto de vista da criação/desenvolvimento/implementação

em relação ao seu uso posterior.

Dados que mais se evidenciaram durante as entrevistas

Todos afirmaram que um site é e deve ser visto como um projeto

Flavia DESIGNER

. sobre como situa seu trabalho em um projeto de construção de sites, se vê

como o alavancador de idéias, que força a tecnologia a ir mais longe.

João ANALISTA

Foi dito que qualquer Metodologias sempre tem algum tipo de limitação

Metodologia geral

“Metodologias tem limitações

Metodologia geral”

Sobre a ÚLTIMA QUESTÃO, sobresairam os seguintes pontos

. velocidade é algo muito presente em um projeto de internet. Alan

DESIGNER

. sobre-vida

. reproduzindo

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

131

. pensamento na manutenção

checar quem falou o que

. pós-uso Marcelo PROGRAMADOR

Questões ligadas à manutenção

Perguntas Guias:

- O que você acha que a manutenção significa para o site?

- Que produto é esse?

- Fale sobre o processo de manutenção de um site

- Alguém faz algo que você não faz?

- Se você tiver que subtituir alguém e precisa saber de algo que não foi

você quem fez (você tende a primeiro olhar a tarefa ou procurar

documentação?)

Quando é necessário criar novas páginas, o que deve ser observado? Quais

os cuidados?

Dados que mais se evidenciaram durante as entrevistas

Emergiram referencias a

. MANUAL

. tecnologia – Flavia DESIGNER

. projeto – CONCLUSÃO - Gr: de existir um projeto de manutenção, da

manutenção ser encarada como um projeto – Soraya ANALISTA e Alan

DESIGNER – Pr, Fu

. expiração

Marcelo PROGRAMADOR

. registra o que você faz Pr

Sobre a última pergunta – cuidados observados:

. estrutura - Flavia DESIGNER

. vínculos - Marcelo PROGRAMADOR

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

132

Questões ligadas ao papel da documentação na manutenção e gerência de

sites

Perguntas Guias:

- A que lhe remete a palavra documentação ou o ato de documentar?

- Você documenta seus projetos? Como?

- Você acha importante documentar um site? Porque e para que?

- Como você documentaria sua parte e como você acha que as outras

partes deveriam ser documentadas?

- Em um site, o que você considera elemento de projeto de design e

elementos de projeto de Informática?

- Um mesmo elemento pode ser considerado elemento de design e de

Informática? Exemplos???

- como se documenta um mouse over? E uma tabela? E um floater?

O que é design e informática em cada um deles?

- Como você documentaria um elemento que considera só de Design, um

que considera só de informática, e um que considera uma interseção dos

dois?

- Você acha que existem elementos de um site que nasceram dessa relação

entre Design e informática? Quais? Como documentá-los?

- Qual a relação de dependência entre elementos de Design e Informática

de um site?

- Você acumula funções?

- Você recorre (com frequência ou não) a documentação?

- Como você acha que o que você faz devia ser documentado, de forma a

ser compreendido por pessoas de outras áreas, que precisem atualizar um

site?

- Como você gostaria de ver documentado o que outro fez, para que você

possa utilizá-lo. Cite um exemplo da sua área, um caso seu.

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

133

- É necessária a existência de uma metodologia de documentação própria

para sites? Porque? O que está faltando nos formatos de documentação

atual?

- Você acha que a documentação teria algum papel no processo de

manutenção de um site? Qual? (atualização/criação de novas páginas)

Você gosta de trabalhar com metodologia?

Dados que mais se evidenciaram durante as entrevistas

As pessoas de manutenção (Soraya ANALISTA, Flavia DESIGNER)

demonstraram um entendimento maior do fluxo e da relação construção ->

manutenção

Sobre FORMAS DE DOCUMENTAÇÃO/REPRESENTAÇÃO

. citou a comunicação em texto como algo que pode ser universalmente

compreendido, independente da área - Soraya ANALISTA - Ab

Deu como exemplo:

- explicações passo a passo

- comunicações em texto – descritivas – também citado por Marcelo

PROGRAMADOR

- evitar vocabulários fechados SÓ DE UMA ÁREA ou explicá-los - (Soraya

ANALISTA, Flavia DESIGNER) – Ab

. Esboços direto no computador (Alan DESIGNER)

. mostrar 3 visões de um elemento, uma sob o aspecto de design, uma sob o

aspecto de informática e uma como um todo. Ab - Alan DESIGNER).

. a página como um elemento (com seus aspectos e elementos de design

juntos, ou inseparáveis – Ab - Soraya ANALISTA, Alan DESIGNER –

. A Interface foi citada muitas vezes como exemplo de elemento de design,

como um todo, onde não se via seus elementos separadamente, “e uma

forma de documentar o site sem separar elementos de Design e Informática”

(Marcelo PROGRAMADOR) – Ab - CONCLUSÃO - Gr: pode ser de

certa forma considerada um elemento de área de fronteira, podia-se levar

essa visão para documentar elementos dentro das páginas , como foi citado

para o Floater.

. documentar por tarefa a ser feita - Soraya ANALISTA – Ab, Re, Pr, Fu

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

134

. animações

. ilustrações

. cada elemento visto como informação

. utilizar recusos multimídia Flavia DESIGNER falar, ouvir, recursos

SENSORIAIS, onde a pessoa que faz a manutenção pudesse ir ouvindo o

que tem que fazer, e ir abrindo janelas, como um Wizard, mas mais

inteligente.

Ex: o áudio sairia dizendo: para atualizar essa imagem, abra o Photshop – e

o “sistema” dispararia o programa. (CONCLUSÃO – Gr – um sistema de

gerência poderia disparar esse tipo de wizard de manutenção. Poderia se

usar recursos de inteligência artificial para criação de sistemas especialistas

voltados a manutenção)

NAVEGAÇÃO – design ou informática?

elemento de informática: João ANALISTA, Soraya ANALISTA

elemento de design - quem disse?

A Interface foi citada muitas vezes como exemplo de elemento de design,

como um todo, onde não se via seus elementos separadamente. – Ab - pode

ser de certa forma considerada um elemento de área de fronteira

Pessoal de desenvolvimento usa menos documentação que pessoal de

manutenção

Pessoal de manutenção tende a se preocupar com o fluxo da informação na

equipe e algumas questões mais ligadas a gerência,

MÉTODOS DE DOCUMENTAÇÃO:

. Utilizar metodologia de Design para documentar Design e metodologia de

Informática para documentar Informática, e desenvolver um método, ou

uma espécie de contrato, para relacionar o uso das duas metodologias Pr,

Ab

. uso de documentos cooperativos, compartilhados pela equipe –

(CONCLUSÃO – Gr – questão relacionado com gerência) . Ma Soraya

ANALISTA

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

135

. documentar enquanto se faz ou logo após acabar a tarefa - Marcelo

PROGRAMADOR Pr, Ma

. normas – 1 etapa da metodologia ??? Flavia DESIGNER

. padrões Flavia DESIGNER

FUNCIONAMENTO, CARACTERÍSTICAS DA DOCUMENTAÇÃO:

. ser recursiva

. estar ligada ao site

Questões ligadas a documentação dinâmica

Pergunta Guia:

- Já que o site está sempre mudando, a documentação teria que ser

atualizada também. Se você concorda com isso, como acha que seria a

melhor forma de manter a documentação atualizada?

Se você não concorda, diga porque.

Dados que mais se evidenciaram durante as entrevistas

Todos concordaram e a resposta a essa pergunta surgiu naturalmente nas

perguntas anteriores.

CATEGORIAS

Re - Formas de documentação/representação

Pr - Processos/métodos 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 ->

manutenção (CONCLUSÃO - Gr: - Designers e pessoal de manutenção

enxergam melhor essa relação, que pode ser resultado, no caso dos designers, de

terem uma formação voltada a entender processos, e no caso das pessoas de

manutenção por causa da experiência de ter função principal receber para

alteração produtos que não foram construídos por eles.

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

136

Ab - áreas de fronteira, sua abordagem e tratamento

Ma - relação documentação x gerência x processo de trabalho da equipe

PRÉ-CONCLUSÕES:

- Formas de Documentação e Representação devem ser combinadas

antecipadamente, e Não se pode confundi-las com os processos e métodos de

documentação.

- Padronizações de nomes de arquivos, diretórios, etc – embora a padronização de

nomes de arquivos e diretórios não tenha emergido da entrevista, ela é adotada

pela equipe e fielmente seguida. A atual documentação do site reserva inclusive

várias 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 elementos do site sem ter que editar o código HTML das páginas.

- Foram feitas mais referências a formatos de documentação do que a métodos.

Entretanto observações e visões importantes sobre métodos e uso de metodologia

emergiram da análise dos dados:

1- 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.

2- Em uma metodologia para geração de documentação adequada a sites,

deve estar especificado que a documentação deve ser gerada/atualizada

juntamente com o processo de atualização/alteraçã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.

3- Emergiu também o fato que esse passo em uma documentação seria

perfeitamente possível, mesmo em ambientes de extrema pressão

experiência, conforme citada pelo Programador Marcelo Hess, baseado em

sua própria experiência: “essa história de dizer que não dá tempo

documentar é uma desculpa furada. Mesmo em circunstâncias de extrema

pressa ou tensão, consigo documentar o que havia sido alterado ou

modificado, mesmo que fosse em um rascunho, para no momento seguinte

ao fim da tarefa, “passa-lo a limpo para a documentação final”... tem que

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

137

ser parte da tarefa atualizar a documentação, caso seja necessário... a tarefa

só deve ser considerada finalizada quando a documentação estiver

atualizada.” Como conclusão poderia-se dizer que em um projeto

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 idéia da

inviabilidade dessa recomendação para uma metodologia de

documentação.

4- Como experiência de coordenadora, poderia complementar a importância

de estar frequentemente checando a atualização da documentação. Esse é

outro dado que deveria estar especificado na metodologia. Pode ser uma

tarefa do coordenador do site.

5- A frequência dessa checagem pode ser determinada pela própria equipe,

mas o ideal é que seja feita sempre que algo mudar, seguida da checagem

do coordenador. Isso evita o efeito “pia de louça suja”.

6- 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. (DESDOBRAMENTO).

Minhas conclusões, consequentes do cruzamento dos dados:

A partir do que foi sugerido por Flavia, a respeito de um Wizard mais

inteligente, que disparasse programas e recursos relacionados à manutenção,

poderia-se desenvolver um sistema de gerência e manutenção, que poderia

disparar recursos do tipo wizards de manutenção. Poderia-se usar recursos de

inteligência artificial para criação de sistemas especialistas voltados a manutenção

de sites. Esse é um desdobramento que pode ser explorado posteriormente.

Desdobramentos

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

138

Embora a dissertação tenha focado no estudo do caso do site da PUC-Rio,

acredita-se que os resultados dessa pesquisa 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 organizada, rápida e diária). Entretanto seria necessário um

novo estudo, como desdobramento deste, para avaliar a total adequação ou não

desses resultados a sites semelhantes.

Recomendação importante para o caso da extensão da pesquisa a casos

semelhantes:

Como 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 todos os aspectos expostos a equipe. Era como se eu estivesse

vivendo uma espécie de auto-entrevista silenciosa. De qualquer forma, a visão do

gerente do site é a mesma minha, expressa nas hipóteses dessa dissertação, em sua

justificativa e nas minhas conclusões à luz da minha experiência como gerente do

site.

Portanto se essa pesquisa vier a ser aplicada em casos de sites semelhantes,

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

informações que forneço nessa dissertação, sob meu ponto de vista como gerente

do site da PUC. Muitas delas encontram-se no capítulo de Metodologia, dentro do

item “elaboração das hipóteses”.

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

139

ANEXO III ANÁLISE DE DADOS – Quadros utilizados para cruzamento das categorias

Nas páginas a seguir são apresentados alguns dos quadros elaborados para

servirem como ferramentas de apoio ao processo de análise de dados. Através do

uso de um sistema de cores (aplicado aos textos), elementos gráficos (setas) e

siglas foi possível esboçar visualmente as relações entre os diversos conteúdos

extraídos durante as entrevistas. Os quadros eram montados a medida em que a

transcrição das fitas era realizada. As conclusões que surgiam ao longo do

processo eram identificadas através da sigla “CONCLUSÃO – Gr” 1. A cor dos

textos, inicialmente preta, era trocada por azul a medida em que os mesmos iam

sendo analisados e cruzados.

1 “CONCLUSÃO – Gr” significa uma conclusão minha. “Gr” vem de parte do meu nome: “Graça”.

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

140

Categorias João - ANALISTA DE

SISTEMAS Soraya - ANALISTA DE SISTEMAS

Marcelo - PROGRAMADOR Alan DESIGNER Flavia DESIGNER

Re Formas de documentação/ Representação/ Formatos/ Tecnologia envolvida na documentação .ilustrações . cada elemento visto como informação . ser recursiva . estar ligada ao site separar da interface seus aspectos de funcionalidade e programação, utilizando-se de recursos da informatica para documentá-los, deixando na Interface apenas os aspectos gráficos, de forma que possam ser documentados com tecnicas tradicionais de documentação de design.

usa TEXTO . falou sobre formalização do problema bem descrita, linguagem natural, texto . animações . código ser comentado (se for atraves de um gerador de documentação, melhor ainda) de maneira clara – uma representação verbalizada, textual do que aquele bando de caracteres está fazendo. . (CONCLUSÃO – Gr . diagramas de classe . diagramas que levam em conta o acontecimento no tempo Jones - representações de alto nível (abstraçoes) Arnheim - tabelas - muitos diagramas - “No caso de projeto específico de sites, uma coisa que tem que ser pensada é a navegação. E na metodologia OOHDM existe um diagrama, o de classes navegacionais, que te dá uma idéia muito boa de como o site vai funcionar (...) eu acho esse diagrama muito importante e ele pode servir de esboço para inicio de uma conversa sobre um site... embora a construção dele não seja a primeira etapa, ele pode ser construido inicialmente, e depois, seguindo os passos da metodologia, contrui-lo novamente, no momento correto e verificar se confere com o que vc havia pensado inicialmente” . Cuidados ao se criar uma página nova: manter a identidade da area onde vc esta colocando a página, divulgar no site 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 (isso tem relação com formatos e formas de representação e metodologia equestoes ligadas ao usuario) Re, Pr, Us - vc tem um objeto e tem especificado o que pode ser feito com esse objeto. E vc pode fazer generalizaçoes 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 dominio comum, animação.

geralmente é TEXTO ou qdo a ideia é algo semelhante que está na web, imprime a página web para registrar. . Sobre formas de documentação/representação, citou a comunicação em TEXTO como algo que pode ser universalmente compreendido, independente da area. É como gosta de receber documentação e como acha que é mais facil de entender por todos. CONCLUSÃO – Gr – claro que pode ser complementado por elementos graficos. “ Minha primeira procupação é com as palavras - explicações passo a passo - comunicações em texto - descritivas - evitar vocabulários fechados SÓ DE UMA ÁREA ou explicá-los, por mais que pareçam óbvios ex: “download – buscar o arquivo em tal lugar, copiar nao sei pra onde – Hackos)” ), jsp, template, library. O daniel qdo entrou aqui perguntou: o que é include? “As vezes vc conhece a palavra nao nao entende o sentido que elea esta sendo utilizada ali” . documentar por tarefa a ser feita . anota ideias que tem por estar em contato diariamente com o site, por causa da manutenção . Lógica: “O designer parte de mil coisas e vai minguando ate chegar no esboço onde quer chegar. Em informática, qual é o objetivo? O Designer abre o leque, e o programador é mais objetivo. Isso qdo é um trabalho de criação livre. Qdo é algo já solicitado, com alguns requisitos, as logicas se aproximam. Eu penso mais com a logica do programador.” ̀. quando me envolvi em tarefas de desenvolvimento eu usei tb fluxogramas, desenhos, rascunhos, e texto.. No desenvolvimento usei mais fluxograms e desenho que uso na manutenção. . Produto do projetpode manutenção: “um manual. Algo que vc recorra. Um projeto que documente, que estruture a manutenção, que diga quem faz o que, nao pessoas, mas o cargo.” - documenta o que faz Formato: um manual online e impresso. Porque se o conteudo é grande, nao pode ser tudo online, porque cansa de ler, principalmente qdo vc tem que recorrer varias vezes e vc esta digitando uma sequencia de codigos, ou vc precisa ler e entender para poder fazer. Pode ser uma coisa online, mas muito facil de imprimir Pode usar formato externo ao site, como planilhar semanais anexadas a parede ou ferramentas de trablho cooperativo, que sirvam como agenda coletiva, com as tarefas que cada um tem que fazer, coisas que vc quer disponibilozar para todo mundo, como reunioes marcadas, e ser uma obrigação todo mundo checar. Assim nao teri apreocupação.

. usa TEXTO

. na criação de novas páginas é necessário observar vínculos . Sobre formas de documentação/representação em TEXTO, deu como exemplo: - textos descritivos - comentários dentro de programas (frase mais curtas e abreviadas e às vezes descritivas) . animações

.ilustrações

. “nao faço muitos esboços, uso o codigo” . uso comentarios e faço uma documentaçao separada. . se for animação posso usar um fluxograma...mas é raro... normalmente eu já uso direto o codigo. - diagramas, fluxogramas - documento word com diagramas, textos - no caso de um site: onde tem varias pessoas trabalhando juntos, é bom ter tudo unificado em um lugar só que ser fácil de usar, para que outras pessoas que virem a trabalhar poderem usar e se for em html é facil por que é navegável – falou sobre Manual Como documentaria uma interface de Webmail (que considera um elemento de Design e Informática): Eu tentaria botarna documentação o proósito de cada elemento da interface, pra que que serve, porque ue foi feito ali” como uma coisa só e como os elementos se relacionam. Como gostria de receber um documentação de Webmail: - ter exemplos de como se faz, 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 – Hackos - . Alguem pode pensar que um elemento da interface serve para alguma coisa, outra pessoa não, entao exemplo é bastante boa tanto para pessoas de engenahria quanto de Desenho Industrial Formato: “já que as coisas do site estão sepradas como de Design ou Engenharia – ou não – como é o caso da Interface, a gente poderia ter uma metologia a nos ajudar a separa isso, a colocar as documentações nos devidos lugares e fazer uma coisa navegável, tanto pra quem é de Design, quanto pra quem é de Engenharia (..) por exemplo: se eu fosse botar no manual uma documentação totalmente nova do nosso site eu separaria em blocos. Se eu quisesse uma documentação do sistema de apoio a gerência (atualmente em desenvolvimento) eu teria o bloco do sistema de gerencia. Se eu quisesse uma documentação sobre a interface do site, teria o bloco: interface do site. Se eu qquisesse uma documentação sobre os códigos, eu teria o bloco de codigo. , cada bloco com seções, e em cada seçaso todas as opçoes da seçao.”

. usa TEXTO (muito falou sobre uso de texto como uma forma de representação) . usa esboços direto no computador . sugeriu um formato de documentação que mostre 3 visões de um elemento, uma sob o aspecto de design, uma sob o aspecto de informática e uma como o todo. . Já trabalhou formatando manuais para a Oracle e Microsoft . usa imgens e texto, porque “se a intenção é fazer com que outra pessoa entenda, é importante usar texto também”. . já usou ate imagens tridimensinais . sobre formato citou ouso de manuais, mas complementou; ö manual deverei ser algo que a pessoa recorre por ultimo. Deveria ser emu ultimo recurso” - falou que muitos manuais sao feitos pelos proprios projetistas, que as vezes esquecem que nem todos entendem o jargão da area.. Tb citou Wizzards (sem usar extamente essa palavra), passo a passo, e tb algo impresso. Prioritariamente online, pois é de mais facil uso . tem coisas que vc não pode descrever graficamente. Tem que narrar.

. usa TEXTO

. na criação de novas páginas é necessário observar cuidados com a estrutura . Sobre formas de documentação/representação em TEXTO: - aconselhou evitar vocabulários fechados SÓ DE UMA ÁREA ou explicá-los . usa esboços direto no computador (VER NA FITA O QUANTO ISSO FICOU CLARO EM RELAÇÃO A COMO O ALAN FALOU) . utilizar recursos multimídia Flavia DESIGNER falar, ouvir, recursos SENSORIAIS, onde a pessoa que faz a manutenção pudesse ir ouvindo o que tem que fazer, e ir abrindo janelas, como um Wizzard, 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 (CONCLUSÃO – Gr . usa desenhos, as vezes corta e cola papel, simula coisas no espaço, antes de levar para o bidimensional. . usa storyboards “a tela é um grande elemento gráfico, partido, com elementos dentro, mas é um grande elemento gráfico”. Como documentaria a parte de Design: . acha que a documentação tem que ter muita imagem printscreen da tela do programa, com as informações que foram usadas para fazer o gif. Como gostaria de receber um documentação da parte de informática: . com textos e exemplos “o equivalente a um desenho técnico de um site é mais complexo do que 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... para deixar ele mais rápido faça isso ou faça aquilo, como salvar uma imagem prá visualização mais rápida.... um sapato eu não vou salvar, ou visualizar melhor ou pior, dependendo de como eu salvar.” Levando-se em conta o ftor tempo: “tem informaçoes de acesso. CONCLUSÃO – Gr - Como o site tem uma vida, a documentação tem que registrar o processo dessa vida “ele vai crescendo e se desenvolvendo e a documentação tem que acompanhar isso. Em outros tipos de produto não tem isso. É o esquema do relógio. Tem o desenho técnico, os materiais, vc pode fazer vários relógios, mas ele não fica se modificando. A hoara que ele mostra, como ele mostra, todo mundo vai saber como funciona. Não fica modificando: agora o 1 fica piscando, etc, agora ele mostra em vários fusos horarios, depois vem horariode verao e ele muda a forma de funcionar.” CONCLUSÃO – Gr - ele não tem essa característica mutante, da imprevisibilidade “a documentação tem que ser atualizada sempre.” ISSO SER UMA NORMA – E uma forma rápida de documentar é FALANDO, e OUVIR tb

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

141

Categorias João - ANALISTA DE SISTEMAS

Soraya - ANALISTA DE SISTEMAS

Marcelo - PROGRAMADOR Alan DESIGNER Flavia DESIGNER

Pr – Processos/metodos de trabalho/padronizações (de representação, de nomes, etc), uso de metodologia . ser recursiva . estar ligada ao site Dar uma pesquisada sobre wml ou wme

. fez uma conexào com Design, como se em Design pudesse ser chamado de bacalhau sendo feito com arte ou de forma experimental, e projeto como algo industrial. . disse que qualquer Metodologia sempre tem algum tipo de limitação Metodologia geral “Metodologias tem limitações Metodologia geral” . Utilizar metodologia de Design para documentar Design e metodologia de Informática para documentar Informática, e desenvolver um método, ou uma espécie de contrato, para relacionar o uso das duas metodologias, relações entre os documentos de 2 metodologias. . “Hoje a gente está trabalhando com OOHDM, que é uma metodologia pra 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 tem para fazer o projeto.” . “Ëu nunca havia pensado em uma metodologia que integrasse Design e Informática. Se vc está projetando um site artistico, vc nao precisa se preocupar tanto com metodologia, mas se vc está vendendo um serviço, o uso de metodologia é importante.

. Acha que deveria existir um “projeto de manutenção”, da manutenção ser encarada como um projeto”, e parte dele cabe a quem desenvolveu, que vai dizer o porque dela e como se altera. Deve ser integrado. . documentar por tarefa a ser feita . “Uma sistematização para mim é fundamental - tempo, controle, controle no sentido de sistematizar as atividades. Característica embutida no trabalho senao não funciona. Precisa 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 hoje de manutenção e não acabe, precisa 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. “É claro 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 também dar um retorno para o usuário que solicitou a atualização. . Eu tenho minha propria metodologia para que eu não esqueça das coisas, para que eu tente cumprir os prazos, cobrar das pessoas que estão ligadas a mim, Eu preciso ter uma lista de pendências (isso eu aprendi contigo). Uso uma Tabela de manutenção, para que eu saiba quem está fazendo o que, e cada um saiba o que tem que fazer. “toda metodologia tem sempre algum tipo de limitação, e essa limitação pode ser suprida por algum outro tipo de metodologia” Acha que deveria existir uma metodologia propria para docuemntar sites. Falta unificar, universalizar, independente do tpo do site, que me diz como eu vou documentar aquilo que estou falando: é imagem, é fonte, texto, programação

.” registra o que vc faz” – ele registra o que faz, a medida que faz . na criação de novas páginas é necessário observar vínculos . sugeriu que deve-se documentar enquanto se faz ou logo apos acabar a tarefa . “Eu gosto de deixar o código bem comprrensível, porque se outra pessoa for utilizar, poderá entender oq ue eu fiz” . a respeito de metodologia: “tem as duas partes, a aprte dificil que vc tem que parender, tem que saber como ela funciona, mas depois que vc tem tudo isso na cabeça fica mail fácil desenvolver alguma coisa, porque é como se vc tivesse uma receita de bolo, um passo a passo”. . Acha necessário ser empregada algum tipo de metodologia na geração de documentação de sites, pois seu uso envolve diferentes tipos de pessoas. Um requisito de uma metodologia para documentar sites: ..... a tarefa só deve ser considerada finalizada quando a documentação estiver atualizada.” “já que as coisas do site estão sepradas como de Design ou Engenharia – ou não – como é o caso da Interface, a gente poderia ter uma metologia a nos ajudar a separa isso, a colocar as documentações nos devidos lugares e fazer uma coisa navegável, tanto pra quem é de Design, quanto pra quem é de Engenharia (..) por exemplo: se eu fosse botar no manual uma documentação totalmente nova do nosso site eu separaria em blocos. Se eu quisesse uma documentação do sistema de apoio a gerência (atualmente em desenvolvimento) eu teria o bloco do sistema de gerencia. Se eu quisesse uma documentação sobre a interface do site, teria o bloco: interface do site. Se eu qquisesse uma documentação sobre os códigos, eu teria o bloco de codigo. , cada bloco com seções, e em cada seçaso todas as opçoes da seçao.”

. Acha que deveria existir um “projeto de manutenção”, da manutenção ser encarada como um projeto, cujo produto gerado seria a documentação – checar isso na fita . Já trabalhou formatando manuais para a Oracle e Microsoft . “a visão do Designer tem que ser ampla. Ela não pode ser focada em uma única coisa”. - Usa metodologia (um pouco do que aprendeu no curso de desenho industrial, adicionado de métodos proprios) - Na sua visão o documento deve ser encarado como um projeto, onde seria “visto”,projetado, Sobre documentação de sites: “eu diria que esse documemto seria outro projeto. Como eu vou fazer com que as pessoas entendam isso que eu fiz aqui, e dessa form. Porque transmitir em palavras, escrito, ou graficamente, é completamente diferente de falar. A forma como eu vou transmitir aqula informação que a pessoa está procurando, é outro projeto. Porque se ela viu o produto, e não soube como usar – Hackos - ela vai ter que pegar o manual e saber. Agora se ela pega o manual e tb 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”e deu como exemplo os manuais de aparelhos de video cassete, onde as vezes nao consta no indice de forma clara tarefas e operações possiveis, ou o significado claro de jargoes, como SP, LP, EP, Stop, Record, Play, Pause . Quando vc vai documentar, tem que projetar a forma como a documentação será utilizada - Hackos CONCLUSÃO – Gr – sobre a necessidade de existir ou nao uma metodologia propria para documentar sites... “eu não posso usar a mesma metodologia que eu usei para fazer meu site. A função é outra. A função do site é passar uma informação e do meu documento, não importa o formato final dele,mas eu vou ter transmitir como eu fiz... é uma coisa interessante...vai ser uma descrição de um processo, só que vai ser um processo também. Eu vou ter que descobrir um meio de como informar o meio que eu usei.. é uma coisa meio recursiva . . Uma metodologia para documentação 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 eu tenho que pensar com olhar da pessoa que vai usar. Eu não sei qdo o programador vai usar nem quando o designer vai usar, mas tem que ser uma linguagem neutra, clara. CONCLUSÃO – Gr – Essa é grande lacuna.

sobre metodologia: . falou que o não uso tende a um trabalho na base de tentativa e erro. . Falou que é uma organização e se alguem tentar reproduzir e dar continuidade (com em industria, qdo 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 arquivos que explica como um gif foi feito,, os efeitos, etc. Onde estao os arquivos originais, etc é uma receita. Até proque vc mesmo esquece. Depois de um tempo vc vai na documentação e olha. . na criação de novas páginas é necessário observar cuidados com a estrutura . padrões – falta padroes. Hj na web nao tem um padroa para algumas coisas, e o ususaario se perde. CONCLUSÃO – Gr - Como o site tem uma vida, a documentação tem que registrar o processo dessa vida “ele vai crescendo e se desenvolvendo e a documentação tem que acompanhar isso. Em outros tipos de produto não tem isso. É o esquema do relógio. Tem o desenho técnico, os materiais, vc pode fazer vários relógios, mas ele não fica se modificando. A hoara que ele mostra, como ele mostra, todo mundo vai saber como funciona. Não fica modificando: agora o 1 fica piscando, etc, agora ele mostra em vários fusos horarios, depois vem horariode verao e ele muda a forma de funcionar.” CONCLUSÃO – Gr - ele não tem essa característica mutante, da imprevisibilidade “a documentação tem que ser atualizada sempre.” ISSO SER UMA NORMA . normas – 1 etapa da metodologia – E uma forma rápida de documentar é FALANDO, e OUVIR tb CONCLUSÃO – Gr – no caso da PUC isso é viavel, ,mesmo em condições de muita pressao ou pressa

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

142

Categorias João - ANALISTA DE SISTEMAS

Soraya - ANALISTA DE SISTEMAS

Marcelo - PROGRAMADOR Alan DESIGNER Flavia DESIGNER

Fu- Função que desempenha x visão da ligação construção do site -> manutenção

. demonstraram um entendimento/preocupação maior do fluxo e da relação construção -> manutenção ““sempre penso: o que se pode fazer para tornar mais facil a manutenção?” . documentar por tarefa a ser feita”. . “Eu vejo a manutenção como um projeto. Assim como tem u projeto de desenvolvimento, deveria haver um projeto de manutenção”

. na criação de novas páginas é necessário observar vínculos . demonstraram um entendimento/preocupação maior do fluxo e da relação construção -> manutenção

. Já trabalhou formatando manuais para a Oracle e Microsoft . “a visão do Designer tem que ser ampla. Ela não pode ser focada em uma única coisa”.

. na criação de novas páginas é necessário observar estrutura . demonstraram um entendimento/preocupação maior do fluxo e da relação construção -> manutenção . normas – 1 etapa da metodologia ???

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

143

Categorias João - ANALISTA DE SISTEMAS

Soraya - ANALISTA DE SISTEMAS

Marcelo - PROGRAMADOR Alan DESIGNER Flavia DESIGNER

Ab – áreas de fronteira, sua abordagem e tratamento . cada elemento visto como informação

. Utilizar metodologia de Design para documentar Design e metodologia de Informática para documentar Informática, e desenvolver um método, ou uma espécie de contrato, para relacionar o uso das duas metodologias “Eu acho que o Designer definiria meu trabalho bem como a área da programação mesmo, da pessoa que vai fazer com que tudo aquilo funcione, de alguém que vai fazer um código para fazer o que aquilo tem fazer” “Projeto é uma sequencia de etapas, de passos, que consomem recursos, tempo e que gera um produto no final.” . Site é um produto virtual de Design e Informática – não tem como separar. “ . Semelhança entre um sistema e um produto de design – linha de produção, uso por uma pessoa

NAVEGAÇÃO – design ou informática? elemento de informática: . “O que posso definir de semelhante seriam as folhas de estilo, por exemplo, vc pode definir classes de objetos que vc está usando, e vc diz que esse objeto vai ter determinadas caracteristicas, caracteristicas visuias, tipologia, tamanho, caracteristicas que influem no visual final e vc aplica essa definição aos objetos de acordo com uma regra, por exemplo: vc vai usar determinado estilo em todos os cabeçalhos, ou a todas as imagens que aparecem em determinado nivel do site. Entao vc tem estilos, que são definições de uma composiçao visual e vc tem uma regra de aplicação” Isso seria uma forma de fazer, de representar a parte de Design, uma forma que tornaria a documentação mais unificada em relação ao que ele conhece

. “A parte de informática está relacionada com o conteúdo e a parte de Design com a apresentação dela. E tem tb uma area de comunicação, de transmissão de mensagem” . “um gif pode ser aquilo que vc está vendo, ou um padrao de bytes organizados no padrao gif, e isso é informatica. E o que vc vê é Design” . “a interação entra na área de HCI (Interaçao homem-Computador, que abrange outras áreas . “Vejo na araea de interface uma interseção entre muitas outras areas alem de Design e Informática” - vc tem um objeto e tem especificado o que pode ser feito com esse objeto. E vc pode fazer generalizaçoes 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 dominio comum, animação.

. Sobre formas de documentação/representação, citou a comunicação em TEXTO como algo que pode ser universalmente compreendido, independente da area. deu como exemplo: - explicações passo a passo - comunicações em texto - descritivas - evitar vocabulários fechados SÓ DE UMA ÁREA ou explicá-los ) . na documentação, a página poderia ser encarada como um elemento (com seus aspectos e elementos de design juntos, ou inseparáveis), ou seja documentar por página. . documentar por tarefa a ser feita “Projeto de Design é o corpo, projeto de sistema é a alma, aquilo que ninguem ve mas que tem que estar por tras para poder funcionar.” “o que o usuário busca é a informação. Se ele encontra o que quer, o bjetivo foi cumprido, mesmo que seja uma tela simples, sem projeto gráfico. Mas hj em dia existe uma cobrança para que o lado visual seja trabalhado”. Elemento de Design: Elementode Informática:

NAVEGAÇÃO – design ou informática?

elemento de informática: mouse over: o ato é de informatica, a imagem é design A funcionalidade é informática. Documemntacao do mouse over seria feita de forma integral, explicando o eleemnto como umtodo CONCLUSÃO – Gr – sob o ponto de vista de manutenção, onde o objetivo é realizar a tarefa, seria um caminho para dar a visao geral da tarefa. Como documentar Navegação: um elemento visual que simulasse, que mostrasse a estrutura e que vc pudesse navegar nessa estrutura, de forma dinamica, que viajasse com vc pela estrutura. Elemento que só exista em site, que nasceu da fronteira entre Design e Informática: imagem mapeada (image map). É uma imagem, que tem por tras uma programação. Como documentar: em função do uso. Objetivo é alterar a imagem? Alterar o link da imagem? Pegar o conjunto, dizendo o que é, e dizendo: se deseja alterar a iamgem, sig aesses passos, se deseja alterar a url, ou o mapeamento, siga esses passos . Acha que deveria existir uma metodologia propria para docuemntar sites. Falta unificar, universalizar, independente do tpo do site, que me diz como eu vou documentar aquilo que estou falando: é imagem, é fonte, texto, programação. Na documentação, deve separa Design de Informática? “Acha que complicaria. Seria melhor dividir por seção, tudo blocado, uma visã ocompleta, onde estariamrelacionados todos os aspectos de design e informática do elemento. A informação completa, comtodos os seus atributos. Poderia ser expandido a um nivel de página

. na criação de novas páginas é necessário observar vínculos NAVEGAÇÃO – design ou informática? Considera um site um Produto de Design, de Informática e de Comunicação. Um produto tem essas tres partes: a parte estética, a parte de comunicação e a parte funcional. . Acha que a lógica do designer e do programador sao bem diferentes, e que existe uma complemetação entre ambas. Dai que vem a riqueza que qdo sentam juntos para trabalhar. Como documentar para pessoas de outras areas usarem: “tem que ser pensada para quem vai ser feita a documentação, de forma que não sejam usados termos que sejam comuns para uns e obscuros ou não muito claros para outros”. Deu exemplo do Photoshop, layers e string entre aspas “mas sabendo que a documentação de Design é bem mais provável de ser usada por pessoas de Design,ela deve se preocupar 80% em documentar de forma a ser usado por pessoas de Design, e 20% por pessoas de outra area. Porque qdo ela faltar é mais provavel que alguem Design vá substitui-la, do que eu. “por outro lado,se eu for fazer uma documentação, vou fazer para alguem de engenharia ou informática. Mas eu tb tenho que deixar claro o jeito de como deve ser usado para qualquer pessoa que seja. Se a Flavia quiser usar uma função, ela conseguir entender como funciona”. . considera a Interface um eleemnto de design e informática Elemento que só exista em site, que nasceu da fronteira entre Design e Informática: “a interface está ligada aos dois e não tem como separar,mas não é algo só de um site. Esttá em outros produtos que envolvam Engenharia e Desenho Industrial, mas tem certos elementos que você usa mais em site do que em outros projetos. A interface de um Webmail (explicar isso), é uma coisa que só vê em site. Vc tem aqueeas caixas de escrever o texto, de escrever o assunto,para quem você está mandando, vc tem aqueles botões de apagar mensagem, de selecionar mensagem, enfim é uma interface típica de um site, e onde não se separa Engenharia de Desenho Indutrial. Como documentaria uma interface de Webmail: Eu tentaria botarna documentação o proósito de cada elemento da interface, pra que que serve, porque ue foi feito ali” como uma coisa só e como os elementos se relacionam Como gostria de receber um documentação de Webmail: - ter exemplos de como se faz, 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 – Hackos - . Alguem pode pensar que um elemento da interface serve para alguma coisa, outra pessoa não, entao exemplo é bastante boa tanto para pessoas de engenahria quanto de Desenho Industrial NAVEGAÇÃO – design ou informática?

Os dois. Qual lado é Design? “A forma como é apresentada ao usuário (exemplo: os menus, os caminhos que temos no site (mostrar isso ), links em imagens, includes de rodape e cabeçalho, o list box.” Qual lado é Informática / Engenharia? A busca. Acha que a lógica do designer e do programador sao bem diferentes, e que existe uma complemetação entre ambas. Dai que vem a riqueza que qdo sentam juntos para trabalhar.

. Já trabalhou formatando manuais para a Oracle e Microsoft. . “a visão do Designer tem que ser ampla. Ela não pode ser focada em uma única coisa”. Projeto de design ou Informática? Ambos .De certa eu programo, eu colaboro na programação, pois eu penso como a p[agina vai funcionar - design como um interlocutor entre o conteudo e o usuário, mas tb está transmitindo . defende que 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 tecnica de informática esteja fechada. Assim as metodologias de Design e Informatica caminham juntas. . documentar por página ou por funcionamento, abrangendo como foi feito, o codigo, etc . sugeriu um formato de documentação que mostre 3 visões de um elemento, primeiro como um todo, com opção de ver os aspectos de design e informática. CONCLUSÃO – Gr na documentação, a página poderia ser encarada como um elemento (com seus aspectos e elementos de design juntos, ou inseparáveis), ou seja design, informática e a interação (elemento de fronteira). Elemento que só exista em site, que nasceu da fronteira entre Design e Informática: nao conseguiu pensar em um exemplo . Enxerga o Designer por ser um profissional com uma vocação interdisciplinar, como o profssional adequado para projetar a documentação de um site, já que é parte de sua tarefa entender o uso do produto doponto de vista do usuário, o que não o deixaria esquecer o suusuario de informatica, que tb utilizará a documentação (analistas, programadores, etc). Ele trouxe essa responsabilidade para si, como designer. Mas tb acredita que profisssionais de informatica da equipe, pela convivencia interdisciplinar a qual estao submetidos, tb “lembrariam”de entender o uso do ponto de vista do Designer. Acha tb que um profissional de informática sem essa convivencia interdisciplinar, talvez deixasse lacunas.

NAVEGAÇÃO – design ou informática?

. No que se refere a o quanto um site é um projeto de design e o quanto é um projeto de Informática, os dois. “O Design é meio humano e meio tecnológico, então ele raciocina mais rápido falou de funcionalidade . falou que o programador se apega 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 olhar primeiro o todo de um problema. . sobre como situa seu trabalho em um projeto de construcao de sites, ve-se como o alavancador de ideias, que forca a tecnologia a ir mais longe. . na criação de novas páginas é necessário observar estrutura Sobre formas de documentação/representação em TEXTO: - aconselhou evitar vocabulários fechados SÓ DE UMA ÁREA ou explicá-los Sobre qual metodologia usar no desenvolvimento, citou quedeveria ser desenvolvida ou utilizada um ametodologia mixta (de design e Informática), para melhor atender.

Relação de dependencia entre Elementos de Design e de Informática: A informática faz ele funcionar, e o design deixa ele bonito. Elemento que só exista em site, que nasceu da fronteira entre Design e Informática: “Num espaço limitado que é um monitor, eu vejo tudo acontecendo no mesmo espaço. Na TV vc também vê tudo numespaço, mas vc vê um canal só de cada vez. Na Web vc pode abrir zilhoes de janelas ao mesmo tempo.” Documentar por elemento: Design e funcionamento Como gostria de receber um documentação: com exemplos, descrição NAVEGAÇÃO – design ou informática? Os dois. “a disposição de como aquilo vai estar na tela, é a parte do Design. E como essa parte de uma página está ligada a outra, é uma parte de informática”

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA

144

Categorias João - ANALISTA DE SISTEMAS

Soraya - ANALISTA DE SISTEMAS

Marcelo - PROGRAMADOR Alan DESIGNER Flavia DESIGNER

Ma relação documentação x gerencia x processo de trabalho da equipe

. se tem que substituir alguem que nao esta mais na equipe, “primeiro ver qual é a manutenção que tem que ser feita, se tiver alguma documentação, ou alguma fonte de como se fazer. Se nao,testar e ver se consegue fazer a manutençao.”

. entrou naturalmente em assuntos de gerencia, sugerindo uso de documentos cooperativos, compartilhados pela equipe “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 para mim é fundamental.” . “Eu vejo a manutenção como um projeto. Assim como tem u projeto de desenvolvimento, deveria haver um projeto de manutenção”. Se tem que substituir alguem, . se tem que substituir alguem que nao esta mais na equipe, procura documentação . importancia da documentação nesse processo é a de dar independencia, da equipe não depender de pessoas que conheçam como realizar a tarefa e garante minimizar os riscos, minimizar os erros. É vc fazer rápido e sem errar” No acumulo de funcoes, o papel da documetação é fundamental , porque dá uma tranquilidade para realizar a tarefa. USA O MANUAL – para nao ter que decorar coisas, como sintaxe da criaçao de ponteiros, ou de detalhes dos passos. “as pessoas de desenvolvimento não usam o manual. Muito dificial, mas as de Manutenção: eu, o Marcelo e o daniel (estagiário), usamos”, principalmente para manuten’~oes não muito frequentes, onde vc esquece como se faz Formato: um manual online e impresso. Porque se o conteudo é grande, nao pode ser tudo online, porque cansa de ler, principalmente qdo vc tem que recorrer varias vezes e vc esta digitando uma sequencia de codigos, ou vc precisa ler e entender para poder fazer. Pode ser uma coisa online, mas muito facil de imprimir Pode usar formato externo ao site, como planilhar semanais anexadas a parede ou ferramentas de trablho cooperativo, que sirvam como agenda coletiva, com as tarefas que cada um tem que fazer, coisas que vc quer disponibilozar para todo mundo, como reunioes marcadas, e ser uma obrigação todo mundo checar. Assim nao teri apreocupação.

. sugeriu que deve-se documentar enquanto se faz ou logo apos acabar a tarefa . se tem que substituir alguem que nao esta mais na equipe, tende a olhar primeiro o que vai fazer,depois olha a página, analisa o codigo, a estrutura e começa a fazer as mudanças. - no caso de um site: “onde tem varias pessoas trabalhando juntos, é bom ter tudo unificado em um lugar só que ser 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” . Acha IMPORTANTISSIMO documentar um site . .vc 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 vc já tem uma coisa documentada, as vezes vc faz uma coisa, depois começa a fazer outras coisas, e vai que vc tem que recorrer a coisas que já fez no passado... é claro que vc já esqueceu algum detalhe da construção de um código, de uma imagem, e se isso tiver bem documentado, é a só a gente consultar e vai ser mais facil entender. . recorre a documentação qdo é convocado a fazer tarefas de outras pessoas .

“. A documentação funciona como um trouble shooting, para resolver problemas. . “se eu registrar, eu posso melhorar alguma coisa”. . recorre a documementação, se tem que substituir alguém e é uma tarefa que não sabe.

. Falou que é uma organização e se alguem tentar reproduzir e dar continuidade (com em industria, qdo 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 arquivos que explica como um gif foi feito,, os efeitos, etc. Onde estao os arquivos originais, etc é uma receita. Até porque vc mesmo esquece. Depois de um tempo vc vai na documentação e olha. Se tem que substituir alguem, tende a olhar a página, e depois procurar a documentaçõa. Nao sairia mexendo sem antes se informar mel;hor sobre a que seria alterado. O fato do esatgiário recorrer a docmentação a libera de responder perguntas e que o trabalho por ele feito vai ficar muito próximo do que foi feito inicialmente. Vai sair com o mesmo efeito,coma mesma imagem , etc. “a documentação agiliza o trabalho” “a documentação tem que ser atualizada sempre.” ISSO SER UMA NORMA do trabalho –

DBD
PUC-Rio - Certificação Digital Nº 0015561/CA