Ajuda:Transferência

Ir para: navegação, pesquisa
As Orientações de transferência descrvem passos essenciais a sertem seguidos com o objetivo de assegurar um tranquilo e eficiente transporte de artigos da nossa antiga instância do wiki.

Entenda as diferenças do wiki

A formatação do wiki antigo foi a única wiki que o Projeto openSUSE sempre teve. Começamos sem um conceito real e sem a experiência para que as pessoas utilizassem a ferramenta wiki. Em cinco anos de existência, foi utilizado para tudo: como página de desembarque e página de marketing, a tomada de notícias, espaço de colaboração, hardware / base de conhecimento, calendário, pasta de binários, agrupamento de aplicativos, e assim por diante e assim por diante. Basicamente, tentamos mapear o Projeto openSUSE todo dentro do wiki e usá-lo para todas as tarefas possíveis. Isto era tão tedioso que acabamos como um simples depósito de informação.

Pessoas abriam http://en.opensuse.org/Foobar no seu navegador e acrescentavam conteúdo sobre Foobar. Na maioria dos casos, Foobar era um artigo sobre o Foobar e uma solução para um problema que tiveram com ele. Em alguns casos, Foobar era um grupo de artigos sobre um tópico específico. Em quase nenhum caso, as pessoas estavam certos de que Foobar fora corretamente integrado com o resto da wiki. Não havia nenhuma estrutura, nenhuma maneira de navegar e nem visual e aparência consistentes.

O oposto dessas coisas acima descrito é o que tentamos trazer para esta instância agora. Queremos respeitar o fato de que a wiki é uma ferramenta e usá-la para o que for bom para: edição colaborativa para todos. Nós não queremos usá-la para tudo o que está acontecendo no Projecto openSUSE. Desta forma, estabelecemos estes quatro pilares estratégicos:

Estrutura

  • O conteúdo neste wiki está separado por tópicos num par de grupos chamados espaço de nomes. Proeminentemente, o principal espaço de nomes (sem prefixo) para a apresentação da última distribuição openSUSE - pense nisso como o folheto do produto, para pessoas que são novas no openSUSE e talvez no Linux em geral. O suporte do banco de dados (SDB:), espaço de nomes para pessoas que têm um problema com a distribuição openSUSE e procuram instruções escritas sobre como resolvê-lo.
  • E a comunidade do openSUSE (openSUSE:), espaço de nomes para redigir colaborativamente na documentação dos seus projetos e equipes. Com essa estrutura do conteúdo garantimos que este wiki é utilizado apenas para o que é bom para todos.

Navegação

A navegação acontece através de meios comuns a qualquer wiki, mas existem também os portais. Portais são os pontos de entrada para um tema específico, semelhante ao da página principal. Eles fornecem uma visão geral sobre um tópico e guiam os leitores para o conteúdo que procuram, quer seja um outro portal ou um artigo individual. Também classificação é muito importante para a nossa navegação através da wiki, pois possibilita gerar automaticamente páginas de visão geral, bem como as estruturas de navegação. Com estas regras para a navegação garantimos aos nossos leitores que encontrem o conteúdo que produzimos.

Estilização

A estilização de conteúdo se dá através de predefinições. Existem dois tipos, modelos para um determinado tipo de artigo, como o geral predefinição de artigo, um para Portais ou para artigos do suporte do banco de dados e predefinições para estilização de conteúdo recorrente em artigos como introdução e caixas de informações, sugestões e instruções, ou de fontes externas e itens. Com estas regras acerca de estilização nos garantimos de que as pessoas entendam o conteúdo que produzimos.

Garantia de qualidade

Espaços de nomes proeminentes neste wiki são submetidos à Garantia de qualidade (Quality Assurance), que é um processo para garantir que os artigos atendam à qualidade exigida. Este processo de QA acontece através de um sistema que proporciona a oportunidade de acontecerem várias revisões de artigos em paralelo e apenas um ser aprovado pela Equipe Wiki. Isto não limita a criação de novos conteúdos, mas permite apenas o conteúdo de qualidade a ser mostrado por padrão. Com este processo desejamos nos assegurar de que aqueles que nos visitam pela primeira vez sejam atraídos pela qualidade e permaneçam.

Tradução

Importante parte do nosso conceito é que o conteúdo do wiki deve ser acessível às pessoas que não podem usar o Inglês para ler ou contribuir para os artigos. Temos vários projetos de tradução do wiki funcionando e vamos adicionar mais; quando as comunidades openSUSE, usando diferentes linguagens, estiverem fortes o suficiente para realizar a tradução e depois continuar com a manutenção regular do wiki.

Temos também um wiki multilíngue que pode ser usado para iniciar a tradução dos artigos obrigatórios, a fim de criar wikis traduzidos, ou traduzir apenas alguns artigos.

Antes de tudo, certifique-se de compreender essa estratégia e as diferenças para o wiki antigo. Não faz sentido trabalhar neste wiki com o pensamento da instância antiga. Você só vai se confundir e confundir aos outros.

Como decidir quais artigos transferir

Scratch your itch

O lema do Código Aberto "Scratch Your Itch" é um bom caminho para decidir quais artigos transferir. Vocẽ deu pela falta da descrição de um recurso da distribuição? Da solução para algum problema? Da página de sua equipe? Então transfira-a!

Páginas populares

Se não sentiu a falta de nada, mas ainda assim quer ajudar, na lista de páginas populares está o rol de páginas geradas automaticamente na instância antiga para dar uma ideia sobre o que os leitores procuram, dê uma olhada e veja se alguma coisa que está nesta lista não foi transferida ainda.

Como transferir artigos

Primeiro você deve verificar o conteúdo do artigo que deseja transferir. Por favor, n ão tranfira artigos relacionados à tecnologia obsoleta (e.g., ZMD), artigos do suporte da base de dados exclusivamente sobre as versões "sem manutenção" (anteriores a 11.0), páginas de equipes ou projetos que estão desativadas (e.g., JackLab) ou coisas similares. Queremos apenas transferir conteúdo que interesse de agora em diante e não queremos ser compatíveis com o ultrapassado wiki antigo. Na dúvida, pergunte aos membros da equipe wiki na #opensuse-wiki (canal no IRC) ou na lista de correio do wiki openSUSE.

Tópicos inteiros

A melhor prática é escolher um tema e transferir todos os artigos que pertencem a este tópico. Desta forma, você pode garantir que todos os artigos necessários são transferidos de uma forma consistente. Você deve começar com o Portal. Muitas vezes, um tópico já tem uma introdução pronta, embora não esteja no formato de Portal. Ver, por exemplo:

Adaptar essas páginas para o formato de Portal, não só deixará o Portal pronto, mas também lhe dará uma visão sobre os artigos mais importantes para este tópico. Depois de ter adaptado o estilo que você terá vários links em vermelho no Portal, siga-os e transfira os artigos individuais. Se o artigo individual usa uma Predefinição que não existe ainda, tente encontrar uma equivalente em Ajuda:Predefinições_padrão. Geralmente, ajuda para um estilo de conteúdo você encontra no Ajuda:Estilo. No final, certifique-se de que o Portal pode ser acessado a partir da Página Principal, quer diretamente quer através de outro portal. Também certifique-se que todos os artigos individuais que tenham sido transferidos estão acessíveis a partir do seu portal. E que todas as páginas que você criou estão pelo menos em uma Categoria.

Artigos individuais

Se você está transferindo um artigo individual, porque o Portal ou o artigo individual você pode vinculá-lo a partir de um já existente, basta pular todas as etapas Portal da descrição acima.