Version 6 (modified by vitorchoi, 10 anos atrás) (diff)

--

Resumo

Este artigo detalha os procedimentos e melhores práticas para a criação de artigos na Base de Conhecimento do GITEC.

Mais Informações

À primeira vista, os artigos da Base de Conhecimento não são muito diferentes de uma página qualquer do Wiki. O que as diferencia são:

  • Os artigos devem ser escritos conforme uma estrutura definida neste artigo, enquanto as páginas do Wiki não precisam seguir este guia.
  • Os artigos da Base de Conhecimento são obrigatoriamente categorizados com tags específicas para cada assunto.

Orientações para a criação de novos artigos

  • O nome da página deve ter o prefixo bc, pode conter espaços mas não acentos ou cedilha.
  • Utilize o modelo ArtigoBC, que será oferecido ao criar uma página nova.
    • Escreva um resumo sucinto para o artigo de forma que o leitor possa identificar rapidamente se vale a pena continuar lendo o artigo. Um parágrafo basta.
    • Se você estiver escrevendo um artigo longo, utilize sub-títulos para estruturar o artigo.
    • Nas referências utilize preferencialmente permalinks, documentação oficial, mensagens arquivadas da lista e outros artigos da Base de Conhecimento.
    • Geralmente os artigos têm um escopo de aplicação bem definido. Detalhe neste campo a aplicabilidade das informações do artigo para que o leitor não tente aplicar o conteúdo do artigo a versões erradas de software, etc.
    • Inclua o tag bc e quaisquer outros tags relevantes para o assunto do artigo. Consulte a lista de tags: wiki:'bc/Lista de Tags'

Perguntas Frequentes

  • Após criar um novo artigo, o mesmo não aparece quando pesquisado na nuvem.
    • Certifique-se de que classificou o artigo com o tag bc e outros tags apropriados para o assunto do artigo.
  • Após criar um artigo, aparece um erro "UnicodeEncodeError?: 'ascii' codec can't encode character".

Referências

  • tag:bc

Aplicabilidade

  • Base de Conhecimento do GITEC, desde 06/10/2010.
 

The contents and data of this website are published under license:
Creative Commons 4.0 Brasil - Atribuir Fonte - Compartilhar Igual.