ComoWikificar

Como Wikificar

Introdução

A primeira etapa do trabalho foi concluída com a ajuda de todos. Foi reunida uma grande quantidade de material e o próximo passo é transformar todo este conteúdo em páginas no wiki.ubuntubrasil.org. Para descrever essa tarefa foi criado o termo wikificação, derivado do verbo wikificar. Já a pessoa que wikifica é um wikifier (até o presente momento nenhum destes vocábulos consta nos dicionários Aurélio e Houaiss Smile :) ).

Mas antes de wikificar é preciso entender a importância deste processo. As páginas que serão criadas servirão como um guia para os usuários, tanto para os novos quanto para os experientes, e por isso é importante que estejam bem escritas e detalhadas. Será um "repositório" de dicas, tutoriais e afins,o principal objetivo é centralizar as informações sobre o Ubuntu..

É um trabalho árduo mas de fundamental importância e com a ajuda de todos ficará pronto em breve Smile :)

Wikificando

Criando uma nova página

  • Primeiramente você deve escolher qual tópico deseja wikificar. Para isso vá até a página Garimpos e escolha um tema/topico que goste.

  • Procure na mesma página tudo que estiver relacionado à esse tópico (ex.: Repositórios do Dapper, Sources.list para o 6.06, como adicionar novos repositórios, Atualizando o sistema, etc) Pois todos estes tópicos são relacionados e devem ficar na mesma página, e dentro dela separados por seções diferentes
  • Agora é preciso criar uma página para o conteúdo. Para quem não está acostumado com a criação de novas páginas pode encontrar mais informações aqui.

  • De maneira resumida: por exemplo para criar uma página sobre como instalar um programa chamado abacate basta entrar no endereço http://wiki.ubuntu-br.org/InstalandoAbacate. Será informado que a página não existe ainda e fornece a opção para criá-la. Basta clicar em Create new empty page e pronto. Atenção:

    • Antes de criar uma página nova verifique se alguém já não está trabalhando (ou se já está feito) em um assunto igual ao seu. Isso pode ser conferido aqui.

    • Nem tudo que está na lista deve ser wikificado, pois há muitos tutoriais que não funcionam corretamente, estão obsoletos, ou mesmo muitos são perguntas sem respostas.

Utilizando o Template

Além do conteúdo é importante prestar atenção à formatação das páginas. Um layout atraente torna mais agradável a leitura, facilita o encontro de informações e deixa todo o conteúdo padronizado. Para isso foi criado um Template (modelo) de página para as dicas que serão criadas.

Uma sugestão é entrar em Template e copiar o conteúdo para a nova página. Assim não é preciso se preocupar com a formatação: é preciso apenas editar os campos e conteúdo de acordo com a necessidade.

Dicas para uma boa escrita

Algumas dicas para a escrita do texto:

  • A informação precisa ser escrita de uma forma amigável e detalhada
  • Tenha sempre em mente que algumas coisas para você podem parecer simples (e.g. abrir um terminal) mas são novidades para alguém que acabou de instalar o Ubuntu
  • Deixe claro para qual versão do Ubuntu ou para qual hardware se aplica o que você está escrevendo
  • Nem tudo pode funcionar direito. Se souber algum provável erro que o usuário encontrará comente sobre isso.

Classificação

Com a página pronta o trabalho está quase completo. Falta apenas criar o link para ela na página XXXX. Nesta hora é importante identificar em qual das categorias (ou subcategorias quando houver) o texto criado se enquadra melhor. Isto é fundamental para manter o wiki organizado e facilitar a busca de informações.

Se tiver dúvidas entre em contato com outros wikifires e peça a opinião deles.

Revisão

Depois de escrever o texto é imprescindível uma revisão completa no mesmo. Deve-se tomar cuidado na ortografia, nos links e também nos comandos utilizados. Assim a probabilidade do usuário errar em alguma parte do processo será menor. Ao revisar, verifique se o texto está amigável e de fácil entendimento.

Para auxiliar nesta tarefa sugerimos que envie para a lista de discussão ( ubuntu-br-doc@lists.launchpad.net ) um email com o endereço da página criada ou entre em contato com os revisores.

Responsabilidade

Ao final de cada página wikificada são colocados os créditos do autor original e do wikifier. O wikifier passa a ser responsável por alterações nesta página. Isto não significa que outras pessoas não possam alterar o conteúdo, mas sim que haverá ao menos uma pessoa responsável por revisar o conteúdo de cada página periodicamente ou sempre que necessário.

Como sugestão, o wikifier pode utilizar o link "Subscrever" no topo da página e desta forma ele é avisado por email cada vez que uma alteração é feita.

Créditos

TimeDeDocumentacao/GuiaWiki/ComoWikificar (last edited 2011-09-19 23:18:23 by localhost)