O documento discute a evolução da documentação técnica e do design de comunicação. Apresenta como manuais técnicos tradicionais deixaram de ser a única fonte de informação e como recursos online, fóruns, vídeos e redes sociais tornaram-se alternativas importantes. Também aborda novas abordagens e teorias aplicadas nesta área em constante mudança.

1. http://eurosigdoc.acm.org
1
1/23
Da documentação técnica ao
design de comunicação
Carlos J. Costa
(carlos.costa@acm.org)

2. http://eurosigdoc.acm.org
2
2/23
• Apresentação
• Documentação técnica – Conceitos e Evolução
• Design de comunicação- Novos desafios
• Conclusão

3. http://eurosigdoc.acm.org
3
3/23
Apresentação
• Carlos J. Costa
– Doutorado CTI (SI e Bases de Dados), ISCTE, 2002
• Docente no ISCTE desde 1993
– Departamento de Ciências e Tecnologias de Informação, Escola de Tecnologias e
Arquitectura
– Director do Mestrado em Software de Código Aberto (MOSS)
– Investigador Adetti
– Membro Direcção Audax
• Anteriormente:
– Director da licenciatura em Informática e Gestão de Empresas (IGE)
– Consultor TI/SI
• Chair do EuroSIGDOC – capítulo europeu do ACM/SIGDOC
(http://eurosigdoc.acm.org).
– ACM é a maior associação internacional da área da informática
– SIGDOC é um grupo de interesse da ACM no contexto da comunicação técnica e
design de comunicação

4. http://eurosigdoc.acm.org
4
4/23
Documentação Técnica
Em que consiste a documentação técnica?
• Manuais de utilizadores
• Manuais técnicos
• Material de formação
• Relatórios técnicos
• Comunicação Interna
• Tópicos que tradicionalmente são estudados no SIGDOC –
Grupo de interesse da área da Documentação técnica da
ACM (a maior associação mundial da área da informática)

5. http://eurosigdoc.acm.org
5
5/23
Documentação Técnica
Em face de uma
dificuldade vem a
resposta:
(read the f* manual)

6. http://eurosigdoc.acm.org
6
6/23
Documentação Técnica
A Resposta:
WABM
(write a better manual)

7. http://eurosigdoc.acm.org
7
7/23
Documentação Técnica
• Os gregos apresentam a solução.

8. http://eurosigdoc.acm.org
8
8/23
Documentação Técnica
• Aristótiles apresentou o conceito de Retórica
Ethos
Pathos Logos

9. http://eurosigdoc.acm.org
9
9/23
Documentação técnica
• Muitas tecnicas para produzir manuais de forma mais
eficiente e eficaz
– Técnicas de produção de manuais
– Digitalização dos manuais

10. http://eurosigdoc.acm.org
10
10/23
Documentação técnica
• Surgem novos conceitos e linguagens
• Utilização de diagramas
• Usabilidade

11. http://eurosigdoc.acm.org
11
11/23
Documentação Técnica
• Mas será que alguém lê manuais?
• “Why don't people read the manual?” é um artigo que foi
escrito pelo prof. David Novick da Univ. Texas, El Paso

12. http://eurosigdoc.acm.org
12
12/23
Documentação Técnica
“Several patterns in the responses were evident. Participants
suggested that manuals are:
• physically hard to handle (58 percent of the 19 participants
offered descriptions such as “bulky,” and“cumbersome”)
• hard to navigate (37 percent)
• too basic to be useful (37 percent)
• hard to understand (26 percent)
• unstylish (26 percent characterized manuals as “unstylish,”
“boring,” or “antiquated”)
• out of date with respect to the software (21 percent)”
(Novick & Ward, 2006,p.16)

13. http://eurosigdoc.acm.org
13
13/23
Design de Comunicação
• Sejamos mais específicos...
• Para aprender programação ou para resolver um problema
específico de desenvolvimento de software, que tipo de
recursos os estudantes/programadores utilizam?
• É estudado no artigo “Resources to support computer
programming learning and computer science problem
solving” de Manuela Aparício (ISCTE) e
Rob Pierce (IBM)

14. http://eurosigdoc.acm.org
14
14/23
Design de Comunicação
- Manuais deixam de ser única fonte de informação.
- O e-learning tem tido aceitação crescente
- Fóruns adquirem importância
- Importância das ajudas online (procura Google)

15. http://eurosigdoc.acm.org
15
15/23
Design de Comunicação
- Sistemas de Fóruns
- Videos

16. http://eurosigdoc.acm.org
16
16/23
Design de Comunicação
- Jogos e ambientes simulados

17. http://eurosigdoc.acm.org
17
17/23
Design de Comunicação
• E … Comunicação com colegas sistemas colaborativos e→
redes sociais tornam esta alternativa mais disponível.

18. http://eurosigdoc.acm.org
18
18/23
Design de Comunicação
• Os utilizadores deixam de ser simples consumidores para
ser prosumidores.
• Os sistemas colaborativos e redes sociais passam a ter um
papel relevante.

19. http://eurosigdoc.acm.org
19
19/23
Design de Comunicação
• DOC do Sigdoc
“Documention”
“Design of Communication”
(depois de 2005)
• 2008 SIGDOC em Lisboa

20. http://eurosigdoc.acm.org
20
20/23
Vídeo

21. http://eurosigdoc.acm.org
21
21/23
Design de Comunicação
Principais teorias de sistemas de informação e teorias de
comunicação aplicadas em trabalhos de investigação
Costa et al. 2012
Theory Authors/SIGDOC
Theory of media synchronicity Verhulsdonck, G. (2007)
Speech acts Novick, D.G., Ward, K.(2003)
Media richness theory Graveline, A, Geisler, C and
Danchak, M. (2000)
Communication Genre Theory Spinuzzi, C. 2004, Costa, C and
Aparicio, M. 2006, Tavares, M &
Costa, C (2007)
Game Theory Costa, C. and Costa. P. (2011).

22. http://eurosigdoc.acm.org
22
22/23
Conclusão
• Design de Comunicação é área em grande evolução
• Novas ferramentas
• Novos meios
• Novos conceitos

23. http://eurosigdoc.acm.org
23
23/23
Referências
• R. Pierce & M. Aparício. 2010. Resources to support
computer programming learning and computer science
problem solving. In Proceedings of the Workshop on Open
Source and Design of Communication (OSDOC '10). ACM,
New York, NY, USA, 35-40
• D. Novick & K. Ward. 2006. Why don't people read the
manual?. In Proceedings of the 24th annual ACM
international conference on Design of communication
(SIGDOC '06). ACM, New York, NY, USA, 11-18.
• Aristotles, Retórica