Re: [Notes2-team] Reorganizando a documentação

[<vml...@ya...>]

  Realmente Anderson, esse meio encontrado é muito
melhor, agora me desculpe ter deixado as coisas
chegarem a esse ponto de você ter que organizar a
documentação, coisa que deveria ter sido feita por
nós, mas confesso que houve falta de comando de minha
parte e também falta de comunicação entre os menbros
da "antiga" documentação.

Robson Cardoso dos Santos
-------------------------
#Ajuda e Suporte

 --- Anderson Rodrigues Barbieri
<and...@po...> escreveu: > Olá pessoar,
> 
> o e-mail é longo, mas espero que todos leiam, pois
> tenho uma proposta para
> reestruturar a área de documentação que diz respeito
> a todos do Notes, pois
> um dos pontos é justamente integrar mais a equipe de
> documentação e a 
> documentação
> a todas as partes do Notes. Então respirem fundo e
> vamos lá. Quem não 
> ler que
> não reclame depois!
> 
> Há algumas semanas atrás o Robson pediu demissão do
> "cargo" de coordenador
> da área de documentação do Notes. Na época eu disse
> que estávamos 
> conversando
> sobre possibilidas, mas a conversa parou sem que
> tenhamos encontrado 
> solução alguma.
> 
> Enquanto não encontramos um novo coordenador, acho
> que cabe a mim ajeitar a
> bagunça e colocar o povo para trabalhar, não?! Bom,
> depois que instalei 
> o windows XP
> tive algumas idéias novas, tanto sobre a
> documentação quanto sobre como 
> tornar o Notes
> mais usável (no sentido de usabilidade). Hoje
> consegui agrupar tudo para 
> formular
> a proposta que apresento a seguir de uma
> reformulação não apenas do time de
> documentação mas, também, do modo como pensamos
> documentação dentro do
> Notes. A porposta vem dentro da linha das sugestões
> que apareceram na 
> lista sobre a
> documentação - apenas estou levando aquelas idéias
> ao extremo :)
> 
> PROPOSTA DE REFORMULAÇÃO DA EQUIPE DE DOCUMENTAÇÃO
>
---------------------------------------------------------------------------------
> 
> PREMISSA 1:
> Usuários não gostam de consultar a documentação, mas
> usuários buscam e 
> precisam
> de ajuda para usar qualquer programa. Usualmente
> documentações são 
> cansativas,
> grandes e muito chatas de ler. Dificilmente se
> consegue encontrar a 
> informação que
> se busca em uma documentação. No geral os usuários
> preferem ler todas as 
> perguntas
> de um FAQ, ler tutoriais e HOW-TOs, pesquisar em
> fóruns a ter que ler a 
> documentação.
> 
> PREMISSA 2:
> A equipe de documentação *não* possui tanto
> conhecimento sobre o Notes 
> quanto a
> equipe de desenvolvimento. Há muita coisa que o
> pessoal da documentação 
> não sabe
> sobre o Notes, então para eles é muito complicado
> escrever algo 
> descrevendo como o
> programa funciona - simplesmente por que eles não
> sabem tanto assim 
> sobre ele!
> 
> CONCLUSÃO:
> A documentação *não* deve descrever como o Notes
> funciona. Deve oferecer 
> ajuda
> sobre dúvidas freqüentes dos usuários. Deve ter mais
> cara de FAQ ou 
> How-to do que
> de documentação. O pessoal da documentação pode não
> saber como o Notes 
> funciona,
> mas, justamente por isto, são as pessoas mais
> indicadas para descobrir 
> quais dúvidas os
> usuários vão ter quando forem usar o Notes.
> 
> PROPOSTA:
> 1. A equipe de documentação deve passar a ser a
> "Equipe de Ajuda e 
> Suporte do Notes".
> Os usuários não precisam de uma bíblia dizendo como
> o Notes funciona - 
> precisa de
> informações que os ajudem a resolver as dúvidas que
> aparecerem enquanto 
> estiverem
> usando o programa. Então é bom que o nome desta área
> já diga isto.
> 
> 2. Os membros da Equipe de Ajuda e Suporte
> funcionarão como "Anjos dos 
> usuários"
> dentro da equipe. Ou seja, não necessarimente terão
> a resposta para 
> dúvidas, mas farão
> as dúvidas serem ouvidas e respondidas dentro da
> equipe. Passa a ser 
> responsabilidade
> da equipe de Ajuda e Suporte basicamente:
> - descobrir quais as dúvidas que os usuários tem e
> terão ao usarem o Notes;
> - conseguir com outros membros da equipe as
> respostas para as dúvidas;
> - sugerir dispositivos, modificações, táticas, etc.
> que tornem o Notes 
> mais fácil de ser usado;
> - indentificar as partes da interface mais difícies
> de serem usadas 
> pelos usuários.
> 
> 
> A AJUDA
> - A ajuda do Notes passará a ser construída no Wiki 
> da documentação. Wikis
> funcionaram muito bem para organizar as informações
> da equipe de 
> desenvolvimento e
> da equipe de marketing e demonstraram que são
> dispositivos que funcionam 
> muito bem
> na equipe do Notes (já o CVS nunca funcionou).
> - Não haverá uma organização inicial da
> documentação, não será feito um 
> índice. No
> lugar disto, os membros da equipe serão incumbidos
> de descobrir as 
> dúvidas que os
> usuários vão ter quando usarem o Notes. Isto não é
> difícil de ser feito, 
> basta abrir o
> Notes e começar a perguntar "como isto funciona?",
> "como faço para fazer 
> tal coisa
> com o Notes", "o que significa isto?" e "para que
> serve esta ferramenta?".
> - Os membros da equipe de Ajuda e Suporte deverão
> registrar estas 
> dúvidas no Wiki e
> incomodar a equipe do Notes para que informem as
> respostas possíveis 
> para cada
> dúvida. Depois que a resposta para uma dúvida for
> dada, os membros da 
> equipe
> devem escrever a resposta final no wiki de forma
> clara e objetiva.
> - Quando muitas dúvidas já tiverem sido coletadas
> (ou seja quando o 
> Notes já estiver
> em fase de finalização), a Equipe de Ajuda e Suporte
> dará uma 
> organização para o
> material.
> - A interface da ajuda do Notes ficará por conta da
> equipe de Marketing 
> e Design.
> Eu gostei da inteface feita para o windows XP (vide
> anexo xphelp3.jpg).
> 
> O SUPORTE
> - Os membros da Equipe de Ajuda e Suporte ficarão
> responsáveis pela área 
> de ajuda
> do fórum do Notes. Eles *não* precisarão responder
> todas as dúvidas dos 
> usuários.
> Mas devem ver perguntas que não foram respondias por
> ninguém e pedir a 
> equipe do
> Notes que respondam. O fórum deve ser vigiado também
> para que mais dúvidas
> possam ser descobertas para que se possa melhorar a
> Ajuda do Notes a 
> partir dos
> problemas que os usuários encontram.
> - Se os membros da Equipe de Ajuda e suporte
> quiserem, poderão oferecer 
> suporte
> por e-mail também e ir conseguindo informações com a
> equipe. (Eu não 
> aconselho
> isso, o fórum me parece ser mais do que suficiente.)
> 
> INTEGRANDO A AJUDA COM O NOTES
> 
=== message truncated ===

> ATTACHMENT part 2 image/jpeg name=xphelp1.jpg


> ATTACHMENT part 3 image/jpeg name=xphelp2.jpg


> ATTACHMENT part 4 image/jpeg name=xphelp3.jpg
 

______________________________________________________________________

Yahoo! GeoCities: 15MB de espaço grátis para criar seu web site!
http://br.geocities.yahoo.com/